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CONVENTIONS USED IN THIS MANUAL 



NOTATION 



{} 



DESCRIPTION 

An element inside brackets is optional. Several elements stacked inside a pair of brackets means 
the user may select any one or none of these elements. 



Example: 



user may select A or B or neither 



When several elements are stacked within braces the user must select one of these elements. 



Example: \ B \ user must select A or B or C. 

italics Lowercase italics denote a parameter which must be replaced by a user-supplied variable. 

Example: CALL name 

name one to 15 alphanumeric characters. 

underlining Dialogue: Where it is necessary to distinguish user input from computer output, the input is 

underlined. 

Example: NEW NAME? ALPHA 1 
superscript C Control characters are indicated by a superscript C 

Example: Y c 

return return in italics indicates a carriage return 

linefeed linefeed in italics indicates a linefeed 

A horizontal ellipsis indicates that a previous bracketed element may be repeated, or that elements 
have been omitted. 



PREFACE 



NOTICE 

All SLEUTH commands applicable in general to moving head discs or applicable specifically to the HP 7905 Disc Drive 
are also applicable in general or specifically to the HP 7920 Disc Drive. 
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GENERAL INFORMATION 



SECTION 



1-1. INTRODUCTION 

The purpose of this manual is to assist the user in understanding the operation of SLEUTH. How the 
user applies SLEUTH to problem solving depends on the nature of the problem and the creativity of 
the user. 

SLEUTH is a stand-alone diagnostic program written in Systems Program Language (SPL). The 
purpose of SLEUTH is to enable the user to generate unique test programs that may be used to isolate 
problems in the I/O section of an HP 3000 Series II Computer System and the peripheral devices. 



1-2. SLEUTH FEATURES 

Common, powerful interactive language for all devices 

Ability to run up to eight devices of various types concurrently 

Ability to write and execute SIO programs for any device 

Ability to store and restore user programs on magnetic tape 

Ability to edit user programs 

SLEUTH format is similar to BASIC language format. 

1-3. HARDWARE REQUIRED 

SLEUTH can be run on an HP 3000 Series II Computer System with the following minimum 
equipment: 

• Central Processor Unit (CPU) with at least 64K of memory 

• Tape Drive Unit for loading magnetic tape 

• System console device with interface PCA. 

1-4. SOFTWARE REQUIRED 

The SLEUTH stand-alone diagnostic magnetic tape is prepared using the Stand-Alone Diagnostic 
Program (SDUPII), Diagnostic No. D417. No additional software is required to load and execute 
SLEUTH. 
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PRINCIPLES OF OPERATION 



SECTION 



2-1. INTRODUCTION 

This section contains the principles of SLEUTH operation. Section III contains operating procedures 
utilizing these principles of operation. 



2-2. LOGICAL UNIT 

The computer system peripheral devices must be identified to the computer as to type and logical 
location. The devices are identified, or declared to the computer, with the Device (DEV) command (see 
page 5-28). The DEV command refers to the devices as logical units and each unit is given a logical 
unit number (LUN). SLEUTH is capable of handling up to eight logical units simultaneously. 



2-3. ERROR PRINT LIMIT 

Each logical unit has an error print limit in the range, to 999, which is set by the user with the DEV 
command. This limit is the number of printing errors allowed. If a device exceeds its error limit, any 
commands referenced to that device are not executed. This allows the user to run multiple devices and 
continue testing others if one should exceed its error limit. 



2-4. POWER FAIL 

SLEUTH has power-fail auto restart capabilities; therefore the panel switch for restart should be 
enabled while running SLEUTH. If a power-fail is encountered, the message 

D8 **POWER-FAIL** 

is printed on the console. SLEUTH waits 50 seconds to allow discs and other devices to become ready. 
Program execution continues at the point at which it was interrupted. 



APRIL 1977 



2-5. VARIABLES 

SLEUTH has variable manipulating capabilities. Variables may be placed in many of the command 
parameters, allowing these parameters to be dynamically changed during program execution. 

All parameters, except the following, can be variables 

• Step numbers and step number parameters 

• Device declaration parameters (DEV) 

• Dump parameters (DUMP) 

• Define buffer parameters (DB) 

• LUN and BUF parameters 

• SIO PROG parameters (SIO, NAME) 

• SIO order pairs or their parameters 

• Parameters that demand a specific character. 

Bounds checking and arithmetic overflow are not provided for any variable reference. 

The following example illustrates how variables and variable manipulating commands can be used. 

Example: 



> 


10 DEV 0,4,15,100,0 


> 


10 RAND I 
20LETA=I MOD 410 


> 


30SEEK0,A,0,0 


^> 


60 LOOP 10,500 


> 

> 
> 


50 END 
60 RUN 
60 
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2-6. EDITING 

The user has an editing capability inherent in SLEUTH. Statement numbers control the sequences of 
the user's program. Lines may be added to, replaced in, deleted from, and inserted in a program. 



2-7. LINE NUMBERING 

A line of SLEUTH is always preceded by a line number. The number is an integer between 1 and 9999. 
The line number indicates the order of execution. Commands are ordered by SLEUTH from the lowest 
to the highest line number. This order is maintained by SLEUTH, therefore, it is not necessary for the 
user to enter commands in the order of execution so long as the line numbers are in order. 



Example: 



> 10 NOPR 

> 30 ES 

> 20 PR 

> 40 SS 

> 50 PE 



RUNS AS 



> 10 NOPR 

> 20 PR 

> 30 ES 

> 40 SS 

> 50 PE 



SLEUTH is normally in an automatic numbering mode wherein the line numbers are automatically 
supplied. When a program is edited the automatic numbering feature is cancelled. The user must then 
supply the line number or use the AUTO command to resume automatic numbering. 

Example: 

> 10 NOPR 

> 20 

In the above example of automatic numbering the computer supplied the SLEUTH prompt and the 
first line number, > 10; the user entered the NOPR command and the computer responded with a 
carriage return and line feed signifying acceptance of line 10. The computer then prints the prompt 
and the second line number, >20, and halts to await the next user input. 

Example: 



> 10 NOPR 

> 20 SS 

> 30 SS 

> 40 PR 

> 50 PE 

> 60 30 PR 

> 60 AUTO 

> 60 



(Edit command to replace line 30 also terminates automatic numbering.) 
(User supplies line and AUTO. The system resumes automatic numbering.) 
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2-8. ADD OPERATION 

New lines may be added to a program any time since it is the line number that determines the 
sequence of operation. 



Example: 


> 


10 NOPR 


> 


20 PR 


> 
> 


30 ES 
40 



2-9. REPLACE OPERATION 

A previously entered line may be replaced by another line. 

NOTE 

When a program is edited, automatic numbering is cancelled. The 
user must supply the line number or use the AUTO command. 

Example: 



> 


10 NOPR 


> 


20 SS 


> 


30 ES 


> 


40 PR 


> 


50 PE 


> 


60 30 PR 


> 


60 AUTO 


> 


60 DUMP P 




10 NOPR 




20 SS 




30 PR 




40 PR 




50 PE 


> 


60 



(Replaces line 30 and cancels automatic numbering.) 
(User supplies line number and AUTO command.) 
(Dumps program.) 
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2-10. DELETE OPERATION 

A previously written line may be deleted from the program. 



Example: 



> 


10 NOPR 


> 


20 SS 


> 


30 PR 


> 


40 ES 


> 


50 20 


> 


50 AUTO 


> 


50 DUMP P 




10 NOPR 




30 PR 




40 ES 


> 


50 



(Deletes line 20 and cancels automatic numbering.) 
(User supplies line number and AUTO command.) 
(Dumps program.) 



2-11. INSERT OPERATION 

New lines may be inserted between existing lines by using intermediate line numbers. 
Example: 



> 


10 NOPR 


> 


20 SS 


> 


30 ES 


> 


40 15 PR 


> 


40 AUTO 


> 


40 DUMP P 




10 NOPR 




15 PR 




20 SS 




30 ES 


> 


40 



(Inserts line 15 and cancels automatic numbering.) 
(User supplies line number and AUTO command.) 
(Dumps program.) 
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2-12. RENUMBERING 

If many edits are performed on the program, or if automatic numbering is not used, statement 
numbers may become disorganized, as shown below. The renumber command (REN) may be used to 
renumber the program. 

Example: 



> 10 NOPR 



> 


20 11 PR 


> 


12 PE 


> 


13 SS 


> 


25 ES 


> 


33 PR 


> 


34 HALT 


> 


35 AUTO 


> 


44 REN 


> 


80 DUMP P 



(Statement numbers are out of order.) 



(Renumber.) 
(Dump program.) 



10 NOPR 
20 PR 
30 PE 
40 SS 
50 ES 
60 PR 
70 HALT 
an 
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2-13. PROCEED MODE 

SLEUTH can operate multiple devices simultaneously. This mode of operation is termed PROCEED 
MODE. Proceed mode allows the user to test and simulate conditions that would otherwise occur only 
under software system use. 

CAUTION 

When operating in PROCEED MODE the user must take care not 
to generate conditions which would exceed the operating 
bandwidth of the SIO multiplexer. 



Proceed Mode is a privileged mode, and executes as follows (see figure 2-1): 

a. SIO operations are issued to all devices indicated until: 

(1) A command is issued to a device that has a previous operation pending. 

(2) A command is issued to a DRT that has a previous operation pending (that is, multiple units on 
one controller). 

b. Direct I/O operations that do not require an interrupt to complete are issued regardless of any 
pending operations. 

c. Proceed Mode can be turned on or off at any point in the user's program using the Proceed 
command (PROC). 

d. If an operation is encountered that will not execute asynchronously, the command is executed in 
its entirety before proceeding to the next operation. Any previous operations pending are com- 
pleted, and the results of that operation are evaluated. 

Commands that do not operate asynchronously are: 



FMT 


Format 


TDIL 


Terminal Data Interface Loop 


WD 


Write Data 




Asynchronous MUX and Reader/Punch 


RP 


Ripple Print 




for Lineprinters and Asynchronous MUX 


RD 


Read Data 




for Asynchronous MUX 


XDUI 


Universal Interface Data Test 



e. When operating in proceed mode, more than one device should not read into the same buffer, as the 
contents of that buffer will be unpredictable. It should also be noted that a compare buffer 
operation (CB) may begin before the read is completed, thereby producing erroneous compare 
buffer errors. These conditions should be recognized or avoided. 

f. When operating in the proceed mode, if the user has defined his own SIO programs, more than one 
device should not execute the same SIO program. 



C START J 



CHECK IF 
ANY PENDING 
OPERATIONS 
ARE COMPLETE 



INTERPRET 
COMMAND 



EXECUTE 
COMMAND 




COMPLETION 
WAIT 



REPORT 
ANY ERRORS 




YES 



FETCH NEXT 
COMMAND 



Figure 2-1. Generalized Command Execution Flow 
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OPERATING PROCEDURES 



SECTION 



3-1. INTRODUCTION 

This section contains procedures for operating an HP 3000 Series II Computer System and exercising 
the peripheral devices using SLEUTH. It is assumed that the user of SLEUTH has a working 
knowledge of the computer system. 



3-2. SLEUTH TAPE 

The SLEUTH tape is an I/O stand-alone diagnostic tape. The step-by-step procedure for constructing 
such a tape is contained in the HP 3000 Series II Computer System, Stand-alone Diagnostic Program 
(SDUP), Diagnostic No. D417, HP part number 03000-90125. 

The SLEUTH source program is found in 

FIELD . SUPPORT, HP32230 

RUN SDUP. HP32230 . SUPPORT; NOPRIV - (follow programmed console instructions to 

create a stand-alone diagnostic tape). 



3-3. MAKT AND BA 

To make an operating diagnostic tape from the SLEUTH tape constructed in paragraph 3-2, refer to 
the MAKT (Make Test Tape) command and the BA (Batch) command. 



3-4. OPERATING INSTRUCTIONS 

To cold-load the SLEUTH tape, proceed as follows: 

a. Mount cold loadable diagnostic tape containing SLEUTH. Press ON-LINE UNIT 0. 

b. Set Switch Register to %003006. Simultaneously depress 

ENABLE 
LOAD 

A short length of tape should load. The CPU will be in halt mode. 

c. Set the Switch Register to the diagnostic number of SLEUTH. 

d. Press RUN. 

The tape should load and rewind. 

e. Depress carriage-return on the console, the following message will be printed. 

D1 SLEUTH 3000 (HP D411A.XX.X) 
(c) COPYRIGHT HEWLETT-PACKARD COMPANY 1976 
> 10. 

f. Any valid SLEUTH command may now be entered. 

NOTE 

Typing control A on the console aborts any operation and places 
SLEUTH in the input mode. The user's program and data are 
intact. 



WARNING 



Control A will not always break SLEUTH out of a loop. If 
another character other than control A is typed in, any 
subsequent control A will have no effect. 
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ERROR MESSAGES 



SECTION 



IV 



4-1. INTRODUCTION 

This section lists, explains, and shows examples of the various messages a user may encounter while 
running SLEUTH. There are three types of SLEUTH messages: 

• DIAGNOSTIC MESSAGES (DXX) 

• ERROR MESSAGES (EXX) 

• PROGRAM ERROR MESSAGES (PEXX) 

The messages have an alpha/numeric designation; i.e., DXX for diagnostic message, EXX for error 
message, and PEXX for program error message. Following the designator is a self-explanatory 
message. 

4-2 DIAGNOSTIC MESSAGES 

There are 12 diagnostic messages, Dl through D12, that alert the operator to miscellaneous conditions 
that could terminate or otherwise affect a program. See table 4-1 for a list of diagnostic messages. 

Table 4-1. Diagnostic Messages 



D1 SLEUTH 3000 (HP D411A.00.0) 

D2 PASS COUNTER EQUALS XXXXX 

D3 LAST TIO STATUS IS X XXX XXX XXX XXX XXX 

D4 LAST CCG STATUS IS X XXX XXX XXX XXX XXX 

D5 LAST SIO PROGRAM EXECUTED IS 

D6 SIO PROGRAM POINTER EQUALS XXXXXX 

D7 NO CURRENT SIO PROGRAM 

D8 **POWER FAIL** 

D9 LAST SYNDROME IS 

D10 REQUESTED STATUS IS 

D11 SECTOR ADDRESS IS XXXXXX 

D12 ALLOCATION STATUS 



4-3. ERROR MESSAGES 

When SLEUTH detects an error during interpretation or execution of a command, it suppresses 
execution of that command and prints one or more messages describing the error. There are 15 
different error messages contained in SLEUTH. See table 4-2 for a list of error messages. 

The following are examples of error messages: 

Example 1: 

> 10 DEV 0,10,6,10,1,2400 

> 10 RP0.72 



> 20 END 

> 30 RUN 

E2 RP FAILED IN STEP 10 

STATUS IS 100 110 100 000 000 

SHOULD BE 100 110 000 DDD DDD 

The above example is an error from Ripple Print on the Async MUX. The status indicates a break 
character was sensed. 

Example 2: 

> 10 DEV 0,8,14,10,0 

> 10 RC 

> 20 END 

> 30 RUN 

E2 RC FAILED IN STEP 10 
STATUS IS 1 111 000 111 111 010 
SHOULD BE 1 111 000 011 111 000 
CYLINDER = 0,SECTOR = 0,HEAD = 
D5 LAST SIO PROGRAM EXECUTED IS 

35740: 40000 10000 34000 71400 
D6 SIO PROGRAM POINTER EQUALS 35744 

> 30 

The above example indicates pack change status was encountered while doing a recalibrate operation 
on an HP 2888A Disc. 
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Example 3: 



> 10 DEV 0,7,14,3,1 

> 10 DB AA, 128,0 

> 10 SEEK 0,200,5,3 

> 20 RD 0,AA,202,5,3 

> 30 END 

> 40 RUN 



E2 RD FAILED IN STEP 20 
STATUS IS 1 1 1 1 000 000 1 1 1 001 
SHOULD BE 1 1 1 1 000 000 000 001 
CYLINDER = 200.SECTOR = 3,HEAD = 5 
D5 LAST SIO PROGRAM EXECUTED IS 

35740: 41312 50503 77600 36307 34000 177777 
D6 SIO PROGRAM POINTER EQUALS 35744 

> 40 

The above example attempts a read operation from a cylinder over which the heads are not positioned. 
Example 4: 

> 10 DEV 0,5,14,10,0 

> 10 DB AA, 128,0 

> 10 CLR 0,AA 

> 20 END 

> 30 RUN 

E2 CLR FAILED IN STEP 10 

ST ATI IO IO -i -4 A ■* r\f\f\ r\r\A r\r\-t r\r\r\ 

I M I UO IO I I I 1 UUU UU I UU I (JUU 

SHOULD BE 1 111 000 000 000 000 
CYLINDER = O.SECTOR = 0,HEAD = 
D5 LAST SIO PROGRAM EXECUTED IS 

35740: 40000 77600 36307 34000 177777 
D6 SIO PROGRAM POINTER EQUALS 35744 

> 30 

The above example has encountered a cyclic error while executing a cold load read. 
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Example 5: 

> 10 DEV 0,7,24,10,0 



> 


10 DB AA.1.W 


> 


1 (%52525) 


> 
> 
> 


10 DB BB.1,0 

10 MC 

20 WIO 0,%52525 


> 
> 


30 RIO 0,BB 
40 CB 0,AA,BB,1 


> 
> 


50 END 
60 RUN 



E1 RIO FAILED IN STEP 30 CONDITION CODE = CCG 

E2 CB FAILED IN STEP 40 
DATA WORD IS 000 000 000 000 001 
SHOULD BE 101 010 101 010 101 

> 60 RUN 

The above example shows that an RIO operation failed as the device was busy. The subsequent 
compare buffer operation then also failed. 



Table 4-2. Error Messages 



E1 XXXX FAILED IN STEP XXX CONDITION CODE - XXX 

E2 XXXX FAILED IN STEP XXX 

E3 STATUS IS X XXX XXX XXX XXX XXX 

E4 SHOULD BE X XXX XXX XXX XXX XXX 

E5 CYLINDER = XXX.SECTOR = XX,HEAD = XX 

E6 DATA WORD XXXX IS X XXX XXX XXX XXX XXX 

E7 SHOULD BE X XXX XXX XXX XXX XXX 

E8 TRACK = XXX,ARC = XX 

E9 MISSING INTERRUPT IN STEP XXX 

E10 UNEXPECTED INTERRUPT FROM DEVICE XXX IN STEP XXX 

E11 ADDRESS READ IS XXXXXX, XXXXXX 

E12 CHANNEL IS XX SHOULD BE XX 

E13 ERROR COUNT ON LOGICAL UNIT X EXPIRED 

E14 BUFFER IS NOT CORRECTABLE 

E15 RIO STATUS IS X XXX XXX XXX XXX XXX 
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4-4. PROGRAM ERROR MESSAGES 

There are 30 program error messages contained in SLEUTH. The program error message suppresses 
execution of the program and prints a program error message describing the programming mistake. 
See table 4-3 for a list of program error messages. The program error message also points to the last 
error free character, or column position, of the program. 

NOTE 

Each line on a teleprinter contains 72 columns. The columns are 
counter from 1 on the left side of the carriage to 72 on the right 
side. 

The TAB command gives a column number printed across the page to aid the user in locating the error. 
Example 1: 

> 10 DUMP G 

PE1 INCORRECT PARAMETER 
SCAN CEASED AT COLUMN 10 

> 10 

The above example shows that an incorrect parameter was encountered after column 10. 
Example 2: 

> 10 DEV 0,6,18,5,0 

> 10 RS 

PE9 DEVICE TYPE INCOMPATIBILITY 
SCAN CEASED AT COLUMN 9 

> 10 

The above example indicates an operation was attempted which the device cannot perform, i.e., 
random seek to a mag tape. 

Example 3: 

> 10 DEV 15,6,18,10,0 

PE8 INVALID LOGICAL DEVICE 
SCAN CEASED AT COLUMN 1 1 

> 10 

The above example indicates a logical unit was declared out of range. 



Example 4: 

> 10 LOOP 10,999999 

PE16 NUMERIC VALUE OUT OF RANGE 
SCAN CEASED AT COLUMN 13 

> 10 

The above example attempts using a numeric value which is out of range. 
Example 5: 

> 10 DB AA,9000,R 

PE7 MAXIMUM BUFFER AREA DEFINED 
SCAN CEASED AT COLUMN 16 

> 10 

The above example tries to define too large a buffer. 
Example 6: 

> 10 CAB 

PE0 ILLEGAL INSTRUCTION 
SCAN CEASED AT COLUMN 8 

> 10 

The above example uses an illegal instruction. 
Example 7: 

> 10 LOOP 1000,5 

PE2 STEP # OUT OF RANGE 
SCAN CEASED AT COLUMN 15 

> 10 

The above example attempts to loop to a step which is out of range. 
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Table 4-3. Program Error Messages 



PEO ILLEGAL INSTRUCTION 

PE1 INCORRECT PARAMETER 

PE2 STEP # OUT OF RANGE 

PE3 END NOT FOUND 

PE4 BRANCH TARGET NOT FOUND 

PE5 ATTEMPTED DELETION OF ITEM REFERENCED IN STEP XXX 

PE6 UNDEFINED BUFFER OR SIO PROGRAM 

PE7 MAXIMUM BUFFER AREA DEFINED 

PE8 INVALID LOGICAL DEVICE 

PE9 DEVICE TYPE INCOMPATIBILITY 

PE10 ILLEGAL DRT 

PE1 1 ILLEGAL DEVICE TYPE 

PE12 ILLEGAL UNIT NUMBER 

PE13 ILLEGAL BAUD RATE 

PE14 UNDEFINED SIO PROGRAM 

PE15 EXPECTING OCTAL VALUE 

PE16 NUMERIC VALUE OUT OF RANGE 

PE17 ILLEGAL CYLINDER 

PE18 ILLEGAL HEAD 

PE19 ILLEGAL SECTOR 

PE20 INVALID DELETE 

PE21 INVALID REPETITION FACTOR 

PE22 INVALID DATA 

PE23 SIO AREA FULL, ENTER ENDS 

PE24 PROGRAM OVERFLOW 

PE25 ILLEGAL COMMAND IN SIO STATE 

PE26 XXXX FAILED 

PE27 NOT ON TAPE 

PE28 MISSING PARENTHESIS 

PE29 UNRESOLVED FOR LOOP IN STEP XXX 

PE30 SUBSCRIPT OUT OF BOUNDS IN STEP XXX 



Table 5-0. Index of Commands and Mnemonics 



Command Name and Mnemonic 



Page No. 



INDEX OF COMMANDS 
Command Name and Mnemonic Page No. 



Command Name and Mnemonic 



Access Buffer (ACB) 
Address Record (AR) 
Automatic Numbering Resumed (AUTO) 

Backspace File (BSF) 
Backspace Record (BSR) 
Batch (BA) 
Bump Pass Counter (BUMP) 

Change Buffer (CHB) 

Clear (CD 

Clear Unit Busy (CLUB) 

Cold Load Read (CLR) 

Compare Address (CA) 

Compare Buffer (CB) 

Configure (CONF) 

Control (CONT) 

Control I/O (CIO) 

Correct Buffer (CORB) 

Cyclic Check (CO 

Cyclic Check Immediate (CCI) 

Decremental Seek (DS) 
Define Buffer (DB) 
Delay (DELY) 
Device (DEV) 
Display (DISP) 
Dump (DUMP) 

Enable Status (ES) 
End (END) 
EndSIO (ENDS) 
Erase Program (EP) 
Expected Status (ESTA) 

Flag Track Defective (FTD) 

Flag Track Defective Immediate (FTDI) 

For (FOR) 

Format (FMT) 

Forward Space File (FSF) 

Forward Space Record (FSR) 

Gap (GAP) 
Get (GET) 
Go (GO) 

Halt (HALT) 

If (IF) 

Incremental Read (IR) 

Incremental Seek (IS) 



5-4 
5-5 
5-6 

5-9 
5-10 

5-7 
5-11 

5-12 
5-13 
5-14 
5-15 
5-16 
5-17 
5-18 
5-20 
5-21 
5-22 
5-23 
5-24 

5-25 
5-26 
5-27 
5-28 
5-29 
5-30 

5-34 
5-35 
5-36 
5-37 
5-38 

5-39 
5-40 
5-41 
5-42 
5-43 
5-44 

5-45 
5-46 
5-47 

5-48 

5-49 
5-50 
5-51 



Incremental Track (IT) 5-52 

Incremental Write (IW) 5-53 

Initialize Data (ID) 5-54 

Initialize Data Immediate (IDI) 5-56 

Interrupt (INT) 5-57 

Jump (JUMP) 5-58 

Let (LET) 5-59 

List (LIST! 5-61 

Load TIO Register (LTIO) 5-62 

Loop (LOOP) 5-63 

Make Test Tape (MAKT) 5-64 

Master Clear (MC) 5-65 

Name SIO Program (NAME) 5-66 

Next (NEXT) 5-67 

No Print (NOPR) 5-68 

Pack Certification (PCT) 5-69 

Pause On Error (PE) 5-70 

Poll (POLL) 5-71 

Print (PR) 5-72 

Proceed (PROC) 5-73 

Put (PUT) 5.74 

Randomize (RAND) 5-75 

Random Seek (RS) 5-76 

Read (READ) 5-77 

Read Address (RA) 5-78 

Read Address Immediate (RAD 5-79 

Read Clock (RCLK) 5-80 

Read Data (RD) 5-81 

Read Data Immediate (RDI) 5-85 

Read Full Sector (RFS) 5-86 

Read Full Sector Immediate (RFSI) 5-87 

Read Mask (RMSK) 5-88 

Read Next Full Sector (RNFS) 5-89 
Read Next Full Sector Immediate (RNFI) 5-90 

Read Rec with CRCC (RDC) 5-91 

Read with Offset (RWO) 5-92 

Read with Offset Immediate (RWOI) 5-93 

Read without Verify (RWV) 5-94 
Read without Verify Immediate (RWV I) 5-95 

Recalibrate (RC) 5-96 

Renumber (REN) 5-97 

Request Disc Address (RDA) 5-98 

Request Sector Address (RSA) 5-99 

Request Status (RQST) 5-100 

Request Syndrome (RYSN) 5-101 

Request Unit Allocation (RUA) 5-103 



Return Residue (RRES) 


5-104 


Rewind (REW) 


5-105 


Rewind and Reset (RST) 


5-106 


RIO (RIO) 


5-107 


Ripple (RP) 


5-108 


Run (RUN! 


5-109 


Seek (SEEK) 


5-110 


Seek Read Data (SKRD) 


5-111 


Seek Write Data (SRWD) 


5-112 


Select Unit (SELU) 


5-114 


Sense (SENS) 


5-115 


Set Bank (SBNK) 


5-116 


Set Clock (SCLK) 


5-117 


Set Enable/Disable Interrupts (SED) 


5-118 


Set File Mask (SFM) 


5-119 


Set Jumpers (SETJ) 


5-120 


Set Mask (SMSK) 


5-121 


SIN (SIN) 


5-122 


SIO (SIO) 


5-123 


Skip Address Read (SA) 


5-125 


Skip Address Read Immediate (SAD 


5-126 


Status Dump (STAT) 


5-127 


Suppress Status (SS) 


5-128 


Switch Output (SOUT) 


5-129 


Tabulate (TAB) 


5-130 


Terminal Data Interface Loop (TOIL) 


5-131 


Test I/O (TIO) 


5-132 



Universal Interface Data Transfer (XDUI) 5-133 



Verify (VER) 5-134 

Verify Immediate (VERD 5-135 

WIO (WIO) 5-136 

Write (WRIT) 5-137 

Write Address (WA) 5-138 

Write Address Immediate (WAD 5-139 

Write Data (WD) 5-140 

Write Data Immediate (WDD 5-145 

Write File Mark (WFM) 5-146 

Write Full Sector (WFS) 5-147 

Write Full Sector Immediate (WFSD 5-148 

Write Record with Zero Parity (WRZ) 5-149 

Zero Buffer (ZBUF) 5-150 
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SLEUTH COMMANDS 



SECTION 



5-1. INDEX OF COMMANDS 

Table 5-0 is an index of SLEUTH commands and mnemonics. The commands are listed in alphabetical 
order according to formal name. The referenced page number is that page on which the command is 
described in detail. 



5-2. INTRODUCTION 

The SLEUTH command repertoire contains many different types of commands. The extensive set of 
commands gives the user a great range of creative flexibility in the check-out exercising of equipment. 
The types of SLEUTH commands are: 

• Program control which provides the general functions necessary to operate SLEUTH. 

• Direct I/O device commands which allow the user to perform direct I/O operations on the interfaces 
under test. 

• SIO commands which allow the user to build and execute his own SIO programs. 

• Specialized device commands designed to operate on specific devices. 

• Commands which allow the user to check the results of an operation. 
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The set of SLEUTH commands are divided into three subsets. One subset of commands instruct the 
computer system to perform certain control, or utility, functions, and to initiate action immediately 
upon receipt of the command. These commands are executed in the input phase of SLEUTH; they are 
not part of the user's program. The commands in this subset are: 



BA 


Batch 


DB 


Define Buffer 


DEV 


Device Declaration 


DUMP 


Dump 


EP 


Erase Program 


MAKT 


Make Test Tape 


NAME 


Name SIO Program 


REN 


Renumber Program 


RUN 


Run Program 


TAB 


Tabulate 



The second subset of commands are SIO order pair commands used for creating user SIO programs. 
The SIO order pair commands are: 

CO NT Control order pair 

ENDS End order pair 

JUMP Jump order pair 

READ Read order pair 

WRIT Write order pair 

RRES Return Residue order pair 

INT Interrupt order pair 

SENS Sense order pair 

The remaining 112 commands are used to write SLEUTH programs that will be subsequently 
executed. Each command performs a particular function. Each command entered becomes part of the 
current program and is kept until explicitly deleted or the user logs off the system. Programs may also 
be saved in one of the system libraries for future use. 
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5-3. SLEUTH COMMANDS 

The 130 commands available to the user of SLEUTH are listed, and explained in the following format 
(see table 5-1): 



FORMAL NAME 

SYNTAX 

PARAMETERS 

OPERATION 

DELAY TIME 

EXAMPLE 



Formal command name 

Recognized command with parameter list 

Parameter descriptions 

Functional command descriptions 

Default interrupt time out 

Example and explanation 







Table 5-1. 


Elements of Command Format 


• 


COMMAND NAME: 




is shown in CAPITAL LETTERS. 


• 


SYNTAX: 




is shown in CAPITAL LETTERS. 


• 


PARAMETERS: 




are shown in CAPITAL LETTERS IN REGULAR TYPE 
when they are literal information that must always enter 
exactly as shown; 

are shown in lower-case italics when they are variable 
parameters to be replaced by user supplied information. 


• 


OPTIONAL PARAMETERS: 


[A] 


means "A" may be included. 








m 


means "A" or "B" may be included. 








isi 


means "A" or "B" must be included. 








[A] 

[B] 


means "A" or "B" may be included in any order. 


• 


USER INPUT: 




is underlined where necessary for clarity. 


• 


NUMERICAL VALUE: 




is assumed to be decimal except when preceded by per- 
cent sign (%) indicating the number to be octal. 



o-o 



ACCESS BUFFER 

Accesses single word element of a buffer 
or a user defined SIO program. 



ACB 



FORMAL NAME: 



ACCESS BUFFER 



SYNTAX: 



APR \ buf (index) - primary } 
< variable = buf (index) ) 



PARAMETERS: 



buf 
index 



Two letter name of a buffer or SIO program. 

Indicates element to be accessed. May be a constant or a 
variable. 



primary 



May be a constant or a variable. 



OPERATION: 



ACB accesses single word elements of a buffer or a user defined SIO program. 



EXAMPLE: 



> 10 DB AA, 128, R 

> 10 ACB A=AA(1) 

> 20 END 

> 30 RUN 

> 30 



The above example places the value in element 1 of buffer AA into the variable A. 
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AR 



ADDRESS RECORD 

Sets logical address into HP 7905 Disc Controller. 



FORMAL NAME: 



ADDRESS RECORD 



SYNTAX: 



> 



AR lun[ cylinder, head, sector] 



PARAMETERS: 



lun 

cylinder 
head 
sector 



Logical unit number. 



HP 7905 parameters. 



DELAY TIME: 



Default interrupt time-out = 300 milliseconds. 



OPERATION: 



Sets logical address specified in cylinder, head, and sector into the HP 7905 Disc 
Controller. 



EXAMPLE: 



> 10 DEV 0,5,15,100,0 

> 10 AR 0,5,2,3 

> 20 RDA 

> 30 DISP.Q.D 

> 40 END 

> 50 RUN 

D11 ADDRESS READ IS 5,1003 

> 50 



The above example uses the Address Record (AR) command to set the logical disc 
address in the HP 7905 Disc Controller. The Request Disc Address (RDA) command and 
the Display (DISP) command display the address. 
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AUTOMATIC NUMBERING RESUMED AUTO 



Provides automatic line numbering. 



FORMAL NAME: 



AUTOMATIC NUMBERING RESUMED 



SYNTAX: 



PARAMETERS: 



> AUTO [step n] 



step n 



Line number, larger than any line number yet existing in the 
program, at which automatic numbering is to be resumed. 



OPERATION: 



Automatic numbering mode is normal in SLEUTH, but is terminated whenever an edit 
command (add, replace, delete, and insert) is used. The AUTO command reenters the 
automatic numbering mode at step n. 



EXAMPLE: 



> 10NOPR 

> 20 PR 

> 30 SS 

> 40 25 HALT 

> 40 AUTO 

> 40 



In the above example, line 40 inserts line 25. The AUTO command is used to resume 
automatic numbering. 

> 10 SS 

> 20 ES 

> 30 PR 

> 40 NOPR 

> 50 33 HALT 

> 25 AUTO 60 

> 60 

The above example inserts line 33 and resumes automatic numbering at line 60. 
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BA 



BATCH 



FORMAL NAME: 



BATCH 



SYNTAX: 




PARAMETERS: 



record Number from 1 to 999 (decimal) indicating which test on the 

tape is to be restored. 

E_ Indicates tape was made and contains ASCII SLEUTH source 

statements. 



OPERATION: 



BATCH will batchin tests from magnetic tape. The tape must be mounted on DRT 6 
unit 0. If the record parameter is specified the test indicated will be restored only. 
Record is a decimal number between 1 and 999 which will indicate which test on the 
tape to be restored. If record is not specified the entire tape will be batched in and each 
test run in succession until end of file. (See MAKT command.) The "E" parameter 
indicates the tape was made and contains ASCII SLEUTH source statements. The file 
equation used to make this tape must be as follows; 

FILE T;DEV=TAPE;REC= - 80,1 ,F,ASCII 
/K *T « EDITOR COMMAND » 



EXAMPLES: 



FILE T; DEV=TAPE;REC=-80,1,F,ASCII 
:EDITOR 



HP32201A.3.01 
/ SET SHORT 
/A 



EDIT/3000 MON, OCT 14, 1974, 3:21 PM 



1 10 DEV 0,5,13,100,0 

2 10 DB AA,128,W 

3 5(%1 25252),5(%52525),5(%1 77777),5(0) 

4 10 DB BB,128,0 

5 10 RCO 

6 20 RS 

7 30 WDI 0,AA 

8 40 RDI O.BB 

9 50 CB 0,AA,BB,3 

10 60 LOOP 20,100 

11 70 END 

12 // 

/K*T 

/ 

The above example indicates how to make an edit tape using the online text editor. This 
tape can be interpreted using the "BA E" command. For long term compatibility it is 
suggested that online editor tape be used for saving SLEUTH programs. 
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BATCH 

Continued 



BA 



BATCH EXAMPLE: 



> 10 BA E 










> 10 AUTO 




> 80 DUMP P 










10 RC 











20 RS 











30 WDI 


0, 


AA 






40 RDI 


0, 


BB 






50 CB 


0, 


AA, 


BB, 


3 


60 LOOP 


20, 


100, 


0, 





70 END 










> 80 DUMP B 










DB 


AA, 


128 






DB 


BB, 


128 







> 80 

The above example demonstrates how to BATCHIN the tape created in the previous 
example. The declarations are displayed using "DUMP" command 



BATCH EXAMPLE: 



> 10 DEV 0,5,14,100,0 




> 10 DB AA,2944,R 




> 10 DB BB,2944,0 




> 10 NOPR 




> 20 RCO 




> 30 RCO 




> 40 PR 




> 50 IT_0 




> 60 WDI 0,AA 




> 70 CCI 0,23 




> 80 ZBUF BB 




> 90 RDI 0,BB 




> 100 CB 0,AA,BB,3 




> 110 LOOP 50,8119 




> 120 END 




> 130 MAKT N « MAKE A NEW TEST TAPI 


> 130 EP 




> 10BA1 « RESTORE A TEST » 


> 130 DUMP P 




10 NOPR 




20 RC 




30 RC 




40 PR 




50 IT 0, 


0, 0, 


60 WDI 0, 


AA 


70 CCI 0, 


23 


80 ZBUF BB 




90 RDI 0, 


BB 


100 CB 0, 


AA, BB, 3 


110 LOOP 50, 


8119, 


120 END 




> 130 





The above example demonstrates how to create and restore tests generated under 
SLEUTH. 
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BSF 



BACKSPACE FILE 

Issues an SIO backspace file to a magnetic tape unit. 



FORMAL NAME: 



BACKSPACE FILE 



SYNTAX: 



> BSF lun 



PARAMETER: 



> lun 



Logical unit number; must be a magnetic tape unit. 



OPERATION: 



Backspace file will issue an SIO BSF to a specified magnetic tape device. 



DELAY TIME: 



The default interrupt time out is 30 seconds. 



EXAMPLE: 



> 10 DEV 0,6,18,30,0 

> 10 GAP 

> 20 WFM 

> 30 LOOP 10,10 - 

> 40 BSF 

> 50 LOOP 40,9 

> 60 REWO 

> 70 END 

> 80 RUN 

> 80 



The above example demonstrates how a backspace file command might be utilized in a 
user program. Eleven file marks are written on the tape then the tape unit is 
backspaced to 10 file marks. 
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BACKSPACE RECORD 

Issues an SIO BSR to a magnetic tape unit. 



BSR 



FORMAL NAME: 



BACKSPACE RECORD 



SYNTAX: 



> BSR lun 



PARAMETER: 



lun 



Logical unit number; must be a magnetic tape unit. 



OPERATION: 



Backspace record will issue an SIO BSR to a specified magnetic tape device. 



DELAY TIME: 



The default interrupt time out is 10 seconds. 



EXAMPLE: 



> 10 DEV 1,6,18,10,1 

> 10 DB AA,128,R 

> 10 WD 1,AA 

> 20 LOOP 10,10 

> 30 BSR 1 

> 40 LOOP 30,9 

> 50 REW 1 

> 60 END 

> 70 RUN 

> 70 

The above example writes 128 word records, then the tape unit is backspaced through 
10 of these. 
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BUMP BUMP PASS COUNTER 

Increments a pass counter. 



FORMAL NAME: BUMP PASS COUNTER 



SYNTAX: 



> BUMP[P] 



PARAMETER: P If P parameter is specified, the pass counter will be printed each 

time BUMP is executed. 



OPERATION: The BUMP command will increment a pass counter each time the command is exe- 

cuted. The pass counter can be displayed with a DUMP C command (see DUMP 
command). 



EXAMPLE: > 10 DEV 0,5,13,50,0 



> 


10 FMT 


> 


20 BUMP P 


> 


30 LOOP 10,5 


> 


40 END 


> 


50 RUN 



D2 PASS COUNTER EQUALS 1 

D2 PASS COUNTER EQUALS 2 

D2 PASS COUNTER EQUALS 3 

D2 PASS COUNTER EQUALS 4 

D2 PASS COUNTER EQUALS 5 

D2 PASS COUNTER EQUALS 6 
> 50 

The above example shows the pass counter being printed each time the BUMP P 
command is executed. 



CHANGE BUFFER 

Change buffer contents. 



CHB 



FORMAL NAME: 



CHANGE BUFFER 



SYNTAX: 


> 


CHB bu 


f, type 






PARAMETERS: 

i 


huf 
'ype 


TYPE 

A 
R 
I 
D 

S 

w 




Buffer to be changed. 
Type of change. 

FUNCTION 

Fill with address 

Randomize 

Increment 

Decrement 

Circular left shift (shifts bits within each element) 

Circular word left shift (shifts words within buffer) 






Value 






Fill with a numeric value 



OPERATION: 



The CHB command will change the contents of the specified buffer. 



EXAMPLE: 



> 10 DEV 0,5,17,100,0 

> 10 DB AA,4096,R 

> 10 FOR l=0TQ 511 

> 20 DB BB,4096,0 

> 20 WD 0,AA,l,0 

> 30 RD O.BB.I.O 

> 40 NEXT I 

> 50 

> 60 

> 70 

> 80 

> 80 



CHB AA,R 
LOOP 10,1000 
END 
RUN 



The above example uses the change buffer command to randomize the data buffer. 
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APRIL 1977 



CLEAR 



CLEAR 



FORMAL NAME: 



CLEAR 



SYNTAX: 



> CL lun 



PARAMETER 



lun 



Logical unit number. 



OPERATION: 



Clear transmits the clear function to the 7905 disc drive, clears any clock offset, turns 
off the timer, clears status, clears busy on the interface, disconnects all drives and 
resumes polling. 



DELAY TIME: 



The default interrupt timeout is 300 milliseconds. 



EXAMPLE: 



> 10 DEV 0,5,15,100,0 

> 10 CLO 

> 20 END 

> 30 RUN 

> 30 



The above example issues a Clear command to the 7905 disc. 



CLEAR UNIT BUSY 

Clears the busy bit. 



CLUB 



FORMAL NAME: CLEAR UNIT BUSY 



SYNTAX: 
PARAMETER: 
OPERATION: 
DELAY TIME: 



> CLUB lun 



lun 



Logical unit number. 



Clear Unit Busy causes the 7905 controller to clear the busy bit on the addressed drive. 



The default interrupt timeout is 300 milliseconds. 



EXAMPLE: 



> 10 DEV 0,5,15,100,0 

> 10 CLUB 

> 20 END 

> 30 RUN 

> 30 

The above example sends a Clear Unit Busy command to the 7905 disc. 
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CLR 



COLD LOAD READ 

Cold load read to moving head disc. 



FORMAL NAME: 



SYNTAX: 



PARAMETERS: 



COLD LOAD READ 



> CLR iun,buf[, cylinder, head, sector] 



lun 

buf 

cylinder 

head 

sector 



Logical unit number; must be a moving head disc. 
Buffer into which data is read. 

Disc parameters. Default is 0,0,0. 



OPERATION: 



The Cold Load Read command will issue a cold load read to the specified moving head 
disc. The read will take place at the cylinder, head, and sector specified. The informa- 
tion will be read into the designated buffer. That buffer's length will determine the 
word count of the read. 



DELAY TIME: 



The interrupt time out is 300 milliseconds. 



EXAMPLE: 



> 10 DEV 0,7,14,25,0 

> 10 DB AA, 128,0 

> 10 SEEKO 

> 20 CLR 0,AA 

> 30 END 

> 40 RUN 

> 40 

The above example executes a cold load read operation at cylinder 0, head 0, sector 0, 
and reads into buffer AA. 
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COMPARE ADDRESS 

Compares disc address and read command address. 



CA 



FORMAL NAME: 



COMPARE ADDRESS 



SYNTAX: 



> CA lun 



PARAMETER: 



lun 



Logical device number; must be an ISS disc. 



OPERATION: 



The Compare Address command compares the cylinder and head address of the internal 
disc address to the address read from a read address command (see RA command). 



EXAMPLE: 



> 10 DEV 0,7,14,100,0 

> 10 ITO 

> 20 WAI 

> 30 CCI 0,23 

> 40 RAI 

> 50 CAP 

> 60 LOOP 10,8119 

> 70 END 

> 80 RUN 

> 80 



The above example writes addresses, performs a cyclic check, then reads and compares 
a singular address of each track. 
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CB 



COMPARE BUFFER 

Compares contents of two buffers. 



FORMAL NAME: 



COMPARE BUFFER 



SYNTAX: 



PARAMETERS: 



> CB lun,buf l,buf 2,errcount[,maxcount] 



lun 
bufl,buf2 

errcount 
maxcount 



Logical unit number of device being tested. 
Buffers of which the contents are to be word by word compared. 
Maximum number of errors to be displayed for each execution. 
Maximum number of words to be compared. 



OPERATION: 



The Compare Buffer command will compare word by word each element of buffers 1 
and 2. 



EXAMPLE: 



> 10 DEV 0,5,13,25,0 

> 10 DB AA,3072,W 

> 128 (%1 25252), 128(%52525),128(%1 77777), 1 28(0), 128(%22222),128(%11 111) 

> 10 DB BB,3072,0 

> 10 ITO 

> 20 WDl O.AA 

> 30 CCI 0,24 

> 40 ZBUF BB 

> 50 RDI 0,BB 

> 60 CB 0,AA,BB,3 

> 70 LOOP 10,811 

> 80 END 

> 90 RUN 

> 90 

The above example indicates how a compare buffer operation may be used to help 
evaluate the results of an operation. One track of information is written on a 7900 disc 
at one time then each track is cyclic checked, the data read and compared until the 
entire disc is checked. 
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CONFIGURE 

Executes a system I/O configuration test. 



CONF 



FORMAL NAME: 



CONFIGURE 



SYNTAX: 



> CONF 



OPERATION: 



Configure will execute an I/O configuration test on the system. The active DRT's will be 
listed with the device status. The operator must then key in the device type. The type 
codes may be obtained by the "DUMP T" command. If the test is successful a system 
configuration table will be produced. If unsuccessful, an appropriate error message is 
printed, however, the command halts only if the switch register is set for "Halt on Error." 
All peripheral devices should be placed online and made ready, the timer switch enabled, 
and the freeze if interrupt switch disabled before entering this command. 

NOTE 

I/O hardware problems, such as improper polling of devices, has 
caused the CPU to go into an infinite loop or halt with an I/O instruc- 
tion in the CIR. The faulty device number may be found in the TOS 
registers. 



CONFIGURATOR 
HALT 



1 



MEANING 

I/O COMMAND REJECTED (CC= CCL). 

UNEXPECTED INTERRUPT. 
RA = DEVICE NUMBER. 



I/O COMMAND REJECTED (CC=CCG). 

INTERRUPT FROM UNIDENTIFIABLE DEVICE. 
RA = DEVICE NUMBER. 



DEVICE INTERRUPTED MORE THAN ONCE PER 

TEST. 
RA = DEVICE NUMBER. 



6 
%10 



SIO MUX HAS TWO NON-ZERO RAMS. 

INTERRUPTED BY DECLARED NON- 
INTERRUPT DEVICE. 



%11 



UNEXPECTED MODULE VIOLATION. 
RA = PARAMETER. 



%12 



SIO PROGRAM DID NOT COMPLETE. 

RA = DEVICE STATUS, RB = DEVICE NUMBER. 



%13 



DRT CONTAINS WRONG SIO PROGRAM POINTER. 

RA = SIO POINTER, 

RB = EXPECTED POINTER, 

RC = DEVICE NUMBER 



%14 



SIO MUX ADDRESS RAM WAS WRONG VALUE 
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APRIL 1977 



CONF CONFIGURE 



Continued 



EXAMPLE: 



> 10 CONF 




DRT STATUS TYPE 


3 54600 


8 


4 40000 


1 


5 150000 


14 


6 110016 


18 


7 140000 


23 


8 42000 


6 


9 53400 


7 



THE CPU IS CONFIGURED FOR 64K OF MEMORY 
DRT TYPE INT MASK SIO DATA MUX 



3 


8 





E 


NO 


— 




4 


1 


NO 


— 


NO 


— 




5 


14 


3 


E 


YES 


1 


4 


6 


18 


4 


E 


YES 


4 


4 


7 


23 


5 


E 


YES 


8 


4 


8 


6 


1 


E 


NO 


— 




9 


7 


2 


E 


NO 


— 




> 10 















The above example shows a typical system configuration output. The DRT, type, 
interrupt priority, interrupt mask, SIO, service request, and multiplexor channel are 
listed for each DRT on the system. 
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CONTROL 

Places a control command in the order 
address pair of an SIO chain. 



CONT 



FORMAL NAME: 



CONTROL 



SYNTAX: 



CONT wordl, word2 



PARAMETERS: 



wordl 



word2 



Specifies the remaining 12 bit field in the IOCW. 
The IOAW of the order pair. 



OPERATION: 



Control will place a control command in the order address pair of an SIO chain. (See 
NAME and SIO commands.) 



EXAMPLE: 



> 10 DEV 0,6,18,10,3 

> 10 NAME SS 

> 10 CONT 0,%1 400 

> 10 CONT 0,%1 411 

> 10 ENDS I 

> 10 SIO 0,SS,1,5,%114016,%1100 

> 20 END 

> 30 RUN 

> 30 



The above example demonstrates how control double word SIO orders may be placed 
into an SIO program. The program issues a rewind-reset command to magnetic tape. 
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CIO 



CONTROL I/O 

Issues a CIO to specified device. 



FORMAL NAME: 



CONTROL I/O 



SYNTAX: 



PARAMETERS: 



> CIO lun, controlword 



lun 
controlword 



Logical unit number. 
Control I/O word. 



OPERATION: 



CIO will issue a control I/O command of the control specified in the control word 
parameter to the indicated unit. 



EXAMPLE: 



> 10 DEV 0,5,13,20,0 

> 10 CIO 0,%40000 

> 20 END 

> 30 RUN 

> 30 

The above example issues a Control I/O to the device specified. The control word is 
%40000. 
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CORRECT BUFFER 

Corrects a specified data buffer. 



CORB 



FORMAL NAME: 



CORRECT BUFFER 



SYNTAX: 



> 



CORB lun,buf 



PARAMETERS: 



lun 
buf 



Logical unit number; must be an HP 7905 Disc. 
Buffer to be corrected. 



OPERATION: 



Correct Buffer will correct the data buffer specified in the BUF parameter according to 
the last syndrome requested for the logical unit designated. 



EXAMPLE: 



>10 
>10 

>20 

>30 

>40 

>50 

>60 

>70 

>80 

>90 

>100 

>110 

>120 

>130 

>140 

>150 

>160 

>170 

>180 

>190 

>200 

>210 

>220 

>240 

>250 

>260 

>260 



DUMP P 
SS 

LiJ 
LET 

CHB 

WDI 

SEEK 

FOR 

FOR 

RFSI 

ACB 

LET 

ACB 

WFSI 

RDI 

RSYN 

CORB 

CB 

LET 

kU 

NEXT 

CHB 

WDI 

NEXT 

END 

RUN 



B=%1 77776 
C=%1 00000 
AA,%177777 



0, 


AA, 




%2 






&x 


SL 




ix 


1 




J 


- 


3 




TO 128 




I 


- 







TO 15 




0, 


CC 










hx 


■=, 


CC, 




(, J, 


) 


A=(A AND B 


) OR 


C 








CC 


( 


J 




) 


A 


h 


CC 










ix 


BB, 


%2 








£ 












0, 


BB 










Ix 


AA, 


BB, 




3 




B=B CSL(l) 












C=C CSL(l) 

T 












AA,%1 77777 










0, 


AA, 


%2 








J 
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cc 



CYCLIC CHECK 

Cycle check a moving head disc. 



FORMAL NAME: 



CYCLIC CHECK 



SYNTAX: 



PARAMETERS: 



> CC lun,secount[ cylinder, head, sector] 



lun 

secount 

cylinder 

head 

sector 



Logical unit number; must be a moving head disc. 

Number of sectors to be checked. 

Disc parameters. Starting location of check. Default is 
0,0,0. The heads are assumed to be positioned over 
the correct cylinder. 



OPERATION: 



Cyclic Check will perform a cyclic check operation on a moving head disc. 



DELAY TIME: 



The default interrupt time out is 500 milliseconds. 



EXAMPLE: 



> 10 DEV 0,8,14,5,2 



> 


10 DB AA,2944,%1 25252 


> 


10 SEEK 0,250,0,0 


> 


20 WD 0,A,250,0,0 


> 


30 CC 0,23,250,0,0 


> 
> 
> 


40 END 
50 RUN 
50 



The above example writes one track of data on an ISS Disc at cylinder 250, head 0, then 
cyclic checks that track. 
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CYCLIC CHECK IMMEDIATE 

Cycle checks a moving head disc. 



CCI 



FORMAL NAME: 



CYCLIC CHECK IMMEDIATE 



SYNTAX: 



PARAMETERS: 



> CCI lun,secount 



lun 
secount 



Logical unit number; must be a moving head disc. 
Number of sectors to be checked. 



OPERATION: 



Cyclic Check immediate will do a cyclic check on a moving head disc. The starting point 
will be the address contained in the internal disc address. 



DELAY TIME 



The Default Interrupt time out is 500 milliseconds. 



EXAMPLE: 



> 10 DEV 0,5,13,50,0 



> 


10 DB AA,128,R 


> 


10 RS 


> 


20 WDI 0,AA 


> 


30 CCI 0,1 


> 


40 LOOP 10,10 


> 


50 END 


> 


60 RUN 


> 


60 



The above example performs a seek to random locations, writes one sector of informa- 
tion, then cyclic checks that sector. 
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DS 



DECREMENTAL SEEK 

Seeks a location then decrements by one. 



FORMAL NAME: 



DECREMENTAL SEEK 



SYNTAX: 



PARAMETERS: 



> DS lun[ cylinder, head, sector] 



lun Logical unit number; must be a moving head disc. 

cylinder \ 

head > Disc parameters indicating location of initial seek. 

sector ) 



OPERATION: 



Decremental Seek will do an initial seek to the location specified in the cylinder, head, 
and sector parameters, default is 0,0,0. Each time the instruction is executed the 
cylinder will be decremented by 1 until then it will seek to the maximum cylinder. 
This command updates the internal disc address. 



DELAY TIME: 



The default interrupt time out is 300 milliseconds. 



EXAMPLE: 



> 10 DEV 0,5,13,20,0 

> 10 ISO 

> 20 DS 

> 30 LOOP 10,5000 

> 40 END 

> 50 RUN 

> 50 

The above example indicates how a Decremental Seek operation may be used. 
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DEFINE BUFFER 

Defines buffer. 



DB 



FORMAL NAME: 



DEFINE BUFFER 



SYNTAX: 



> DB name, length, datatype 



PARAMETERS: 



OPERATION: 
EXAMPLES: 



length 



datatype 



Two letter buffer name. 

Number of words allocated to buffer. Total length of all buffers 
cannot exceed 8K. 

The type of data to be contained in buffer: 



S 

w 

B 
R 



- String Data 

- Word Data 

- Byte Data 

- Random Data 



value - The buffer is filled with the numeric value. 

S, W and B type buffers will have repetition factors. If a repeti- 
tion factor is larger than a buffer it will be truncated. If smaller, 
the repetition will be repeated until the buffer is full. 



Define a buffer. 



> 10 DB AA,100,W 

> 50 (%12345),50(%54321) 

The above example will fill a 100 word buffer with 50 words of the octal pattern 12345 
and 50 words of the octal pattern 54321. 

> 10 DB BB,120,S 

> THIS IS AN EXAMPLE 

The above example will fill a 120 word buffer with the string "THIS IS AN EXAMPLE". 
If repeating the string does not exactly fill the buffer the last repetition of the string 
will truncate the remainder. 

> 10 DB AS,4000,R 

The above example will fill a 4000 word buffer named AS with random data. 

> 10 DB CC,250,B 

> 100(%123), 100(%321), 50(%177) 

The above example will fill a 250 word buffer with 100 bytes of 123, 100 bytes of 321, 50 
bytes of 177 and will repeat the repetition of each field of bytes until the buffer is filled. 



> 10 DB DD,20,%1 25252 

The above example will fill a 20 word buffer with the octal pattern 125252. 
To delete a buffer simply redefine it. 

> 10 DB DP 

> 10 DB DD,30,%52525 

The above example deletes the buffer, then redefines it. 
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DELY 



DELAY 

Alters the interrupt time out. 



FORMAL NAME: 



DELAY 



SYNTAX: 



PARAMETER: 



> DELY increment 



increment 



Indicates number of 100 millisecond quantums to be allocated to 
the time out. 



OPERATION: 



Delay will alter the interrupt time out of the next command which utilizes interrupt 
time out. 



EXAMPLE: 



> 10 DEV 0,6,18,5,0 



> 


10 DELY 100 


> 


20 REW 


> 


30 END 


> 


40 RUN 


> 


40 



In the above example the delay command was used to change the default interrupt time 
out for the rewind operation to 10 seconds. 
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DEVICE DEV 



Defines device. 



FORMAL NAME: DEVICE 



SYNTAX: 



> DEV lun,drt,type, errs, unit[, baud] 



PARAMETERS: lun Logical unit number, to 7. 

drt DRT number of the devices. 

type Coded number identifying type of device. 

errs Maximum error count the device is allowed, to 999. 

unit Device unit number, to 31. 

[baud] Baud rate, 75 to 2400 baud, optional. 

OPERATION: The Device Command allows the user to define the characteristics of a particular device 

and to assign an error count and logical unit number to that device. 



TYPE 






CODES 


CORRESPONDING DEVICE 




1 


SIO MUX CHANNEL 




2 


CARD READER 




3 


SYNC SINGLE LINE 




4 


HARDWIRE SERIAL 




5 


2607A/13A/17A/18A PRINTER 




6 


ASYNC MUX CHANNEL 




7 


TERMINAL CONTROLLER 




8 


SYSTEM CLOCK 




9 


SEL CHAN MAINT CARD 




10 


READER PUNCH 




12 


7920 DISC 




13 


7900 DISC 




14 


ISS MOVING HEAD DISC 




15 


7905 DISC 




16 


256 TRACK F.H. DISC 




17 


512 TRACK F.H. DISC 




18 


800 CPI MAG TAPE 




19 


1600 CPI MAG TAPE 




20 


PAPER TAPE READER 




21 


PAPER TAPE PUNCH 




22 


PLOTTER 




23 


2610A/14A LINE PRINTER 




24 


SPECIAL INTERFACE (any device not having special 




SLEUTH commands) 




25 


UNIVERSAL INTERFACE 





EXAMPLE: > 10 DEV 0,%1 1,6, 10,2,2400 « ASYNC MUX AT 2400 BAUD >> 

> 10 DEV 1,5,14,3,0 << ISS DISC » 

> 10 DEV 2,6,18,5,1 << 800 CPI MAG TAPE » 

> 10 DEV 0,10,13,2,0 << REDEFINES LUN AS 7900 DISC » 

For further reference see DUMP T and DUMP L commands. 
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APRIL 1977 



DISP DISPLAY 

Displays data. 



FORMAL NAME: DISPLAY 



SYNTAX: 



> DISP lun,type 



OPERATION Display will display the item specified in the type parameter for the lun indicated. 

Type Function 



Y 


Last Syndrome 


D 


Disc Address 


S 


Sector Address 


R 


Requested Status 


U 


Unit Allocation Status 



DELAY TIME: The default interrupt time out is 300 milliseconds. 



EXAMPLE: > 10 DEV 0,5,15,100,0 

> 10 RS 

> 20 RQST 

> 30 DISP 0,R 

> 40 END 

> 50 RUN 

D10 REQUESTED STATUS IS 
001 111 100 000 000 
000 010 000 101 000 

> 50 



Encoded Termination Status (octal) 



00 


Normal completion 




01 


Illegal opcode 




07 


Cylinder compare error 




10 


Uncorrectable data error 




11 


Head-sector compare error 




12 


I/O program error 




14 


End of cylinder 




16 


Overrun 




17 


Possibly correctable data error 


20 


Illegal access to spare track 




21 


Defective track 




22 


Access not ready during data operation 


23 


Status - 2 error 




26 


Attempt to write on protected 


or defective track 


27 


Unit unavailable 




37 


Drive attention 




Status - 2 Format Status 


- 2 Format 


15 ' 


Drive busy 9 


Protected 


14* 


Driver not ready 8 


Attention 


13' 


Seek check 7 





12 


First status 1-6 


Address of last available surface 


11 * 


Fault 


Status - 2 error (true if any bit marked 


10 


Format 


is true) 
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DUMP 

Displays data. 



DUMP 



FORMAL NAME: 



SYNTAX: 



PARAMETERS: 



DUMP 



> DUMP type [;fast] 



type 
T Type Code. 

P [ firstep [ /laststep] ] Program dump will be between the step numbers designated. 
C_ Pass counter dump. 

Logical unit table dump. 



L_ 

V [,var] 



B [,6a/] 


S [,name] 


;fast 



Variable Dump. 

If designated, the contents of a single variable may be displayed. 

Buffer Dump. 

If specified, the contents of the buffer indicated will be 

displayed. 

SIO program dump. 

If specified, the contents of the SIO program will be displayed. 

If ; fast is designated the item will be listed on the lineprinter. 
Otherwise the console. 



OPERATION: 



Dump will list the item specified in the TYPE parameter. 



EXAMPLES: 



> 10 DEV 0,5,14,20,0 








> 10 RS 










> 20 LOOP 10,50 








> 30 RC 










> 40 SEEK 0,405,0,0 








> 50 SEEK 










> 60 LOOP 40,400 








> 70 END 










> 80 DUMP P 










10 RS 











20 LOOP 


10, 


50, 


0, 





30 RC 











40 SEEK 





405, 


0, 





50 SEEK 





0, 


0, 





60 LOOP 


40 


500, 


0, 





70 END 










> 80 











In the above example a program is declared and then displayed using the DUMP P 
command. 
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DUMP 



DUMP 



EXAMPLES: 



> 10 NAME SS 




> 10 CONT0,0 




> 10 WRIT BB 




> 10 ENDSJ 




> 10 NAME SI 




> 10 CONT 0,0 




> 10 READ CC 




> 10 ENDS 




> 10 NAME FF 




> 10 SENS 




> 10 ENDSJ 




> 10 DUMP S 




NAME 


SS 


NAME 


SI 


NAME 


FF 



> 10 

The above example builds 3 SIO programs. The DUMP S command is used to display 
the declarations. 



> 10 DUMP S, SS 

40763: 40000 64060 41770 34000 177777 

> 10 

The above example uses the DUMP S command to display the contents of a SIO 
program. 



> 10 DUMP B,CC 



45710: 
> 10 



1 



The above example uses the DUMP B command to display the contents of a buffer. 



> 10 DUMP C 

D2 PASS COUNTER 

> 10 

The above example shows how to display the contents of the pass counter. 
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DUMP 

Continued 



DUMP 



EXAMPLES: 



> 10 LET A=50 

> 20 LET B=A*2 

> 30 END 

> 40 RUN 

> 40 DUMP V 



A 


= 50 


B 


= 100 


C 


= 


D 


= 


E 


= 


F 


= 


F 


= 


G 


= 


H 


= 


I 


= 


J 


= 


K 


= 


L 


= 


M 


= 


N 


= 





= 


P 


= 


Q 


= 


R 


= 


S 


= 


T 


= 


U 


- 


V 


= 


w 


= 


X 


= 


Y 


= 


z 


= 



> 40 

The above example uses the DUMP V command to display, in decimal, the contents of 
each variable. 



> 10 DEV 0,5,15,100,0 

> 10 DEV 1,7,14,100,0 

> 10 DEV 2,6,18,50,1 

> 10 DEV 3,12,6,105,2400 

> 10 DUMP L 



LUN# 


DEV# 


TYPE 


ERR# 


UNIT# 


BAUD 





5 


15 


100 








1 


7 


14 


100 








2 


6 


18 


50 


1 





3 


12 


6 


10 


5 


2400 










































































> 10 













The above is an example of logical unit table dump. 



5-32 



DUMP 



DUMP 

Continued 



EXAMPLES: 



> 


10 DB AA,128,R 




> 


10 DB BB,2000,%1 25252 


> 


10 DB CC.5,1 




> 


10 DUMP B 






DB AA, 


128 




DB BB, 


2000 




DB CC, 


5 


> 


10 





The above example defines 3 buffers. The DUMP B command is used to display the 
declarations. 



> 1Q DUMPT 
TYPE CODE 

1 

2 

3 

4 

5 

6 

7 

8 

9 
10 
12 
13 
14 
15 
16 
17 
18 
19 
20 
21 
22 
23 
24 
25 
> 10 



CORRESPONDING DEVICE 
SIO MUX CHANNEL 
CARD READER 
SYNC SINGLE LINE 
HARDWIRE SERIAL 
2607A/13A/17A/18A PRINTER 
ASYNC MUX CHANNEL 
TERMINAL CONTROLLER 
SYSTEM CLOCK 
SEL CHAN MAINT CARD 
READER/PUNCH 

7920 DISC 

7900 DISC 

ISS DISC 

7905 DISC 

256 TRACK F.H. DISC 

512 TRACK F.H. DISC 

800 CPI MAG TAPE 

1600 CPI MAG TAPE 

PAPER TAPE READER 

PAPER TAPE PUNCH 

PLOTTER 

2610A/14A LINE PRINTER 

SPECIAL INTERFACE 

UNIVERSAL INTERFACE 



The above is an example of a type code dump. 
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ENABLE STATUS ES 

Enables automatic checking of device status. 



FORMAL NAME: ENABLE STATUS 



SYNTAX: 



> ES 



OPERATION: Enable Status will enable automatic checking of device status unless overridden by the 

setting of the B register switch 7. (See SS command.) 

EXAMPLE > 10 DEV 0,5,13,5,0 

> 10 DB AA, 128,0 

> 10 SEEK 0,100,0,0 

> 20 SS 

> 30 RD 0,AA,200,0,0 

> 40 ES 

> 50 RD 0,AA,200,0,0 

> 60 END 

> 70 RUN 

E2 RD FAILED IN STEP 50 
STATUS IS 1 001 000 000 111 000 

SHOULD BE 1 001 000 D00 000 D00 

CYLINDER =100,SECTOR= 0,HEAD= 
D5 LAST SIO PROGRAM EXECUTED IS 

36140: 40310 50000 77600 36507 34000 177777 

D6 SIO PROGRAM POINTER EQUALS 36144 

> 70 

The above example suppresses status then executes a read from a cylinder over which 
the heads are not positioned. The status is then enabled using the ES command and the 
read is attempted again producing heads mispositioned status. 
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END 



END 

Terminates program. 



FORMAL NAME: 



END 



SYNTAX: 



OPERATION: 



> END 



End terminates the program and must be the last statement of the program. Any 
command having step numbers greater than End will not be executed (and will be lost 
at run time). 

NOTE 

Execution of the program will not occur until the run command is 
given. 



EXAMPLE: 



> 10 1 




> 20 f 


Any SLEUTH 


> 30 ( 


statements 


> 40 ) 




> 50 END 

> 60 





The above example shows that a program must be terminated with an END command. 
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END SIO 



ENDS 



Places an end order in an SIO chain. 



FORMAL NAME: 



END SIO 



SYNTAX: 



> ENDS[,Ij 



PARAMETER: 



If specified, the end will be with interrupt. 



OPERATION: 



End SIO will place an End order in a SIO chain. End SIO also terminates entering SIO 
orders until another NAME command is encountered. (See NAME and SIO commands.) 



EXAMPLE: 



> 10 DEV 0,127,23,10,0 

> 10 NAME FF 

> 10 CONT 123,345 

> 10 SENS 

> 10 CONT 1,2 

> 10 ENDS 

> 10 DUMP S.FF 
35502: 40123 

> 10 NAME CC 

> 10 RRES 

> 10 ENDS.I 

> 10 DUMP S,CC 



35512: 
> 10 



345 50000 177777 40001 2 30000 177777 



10000 177777 34000 177777 



The above example uses both end orders, with and without interrupt. The SIO programs 
themselves perform no particular functions on any specific device but are used here 
only to show how SIO programs might be constructed containing end orders. 
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EP 



ERASE PROGRAM 

Erases program. 



FORMAL NAME: 



ERASE PROGRAM 



SYNTAX: 



> EP [ S] 



PARAMETER: 



The logical unit declarations, data and user SIO programs are 
saved. 



OPERATION: 



Erase Program will eliminate the users program, data, logical unit declarations and 
user SIO programs. 



EXAMPLE: 



> 10 DEV 0,6,18,100,0 

> 10 DB AA,8000,R 

> 10 WD 0,AA 

> 20 REW 

> 30 END 

> 40 RUN 

> 40 EP 

> 10 



In the above example, the EP command erases all entries and recycles the line count. 
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EXPECTED STATUS 

Changes expected status of next command 
which utilizes status checking. 



ESTA 



FORMAL NAME: EXPECTED STATUS 



SYNTAX: 



> ESTA status, mask 



PARAMETERS: 



status 



mask 



Expected Status. 

A word of don't care bits. A 1 bit in the mask corresponds to a 
don't care bit in the status. 



OPERATION: 



This command changes the expected_status of the next command which utilizes status 
checking. 



EXAMPLE: 



> 10 DEV 05,13,100,0 

> 10 ESTA %1 00000,7 

> 20 SEEK 

> 30 END 

> 40 RUN 

E2 SEEK FAILED IN STEP 20 
STATUS IS 1 001 000 011 111 001 

SHOULD BE 1 000 000 000 000 DDD 

CYLINDER = 0,SECTOR= 0,HEAD= 
D5 LAST SIO PROGRAM EXECUTED IS 

75660: 40000 20000 30000 11000 

D6 SIO PROGRAM POINTER EQUALS 75664 

The above example changes the expected status of a SEEK command. 
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FTD 



FLAG TRACK DEFECTIVE 

Flags a defective disc track. 



FORMAL NAME: FLAG TRACK DEFECTIVE 



SYNTAX: 



> FTD lun[, cylinder, head, sector] 



PARAMETERS: 



lun 

cylinder 

head 



sector 



Logical unit number. 



Disc parameters. Default is 0,0,0. The heads are assumed to be 
over the correct cylinder. 



OPERATION: 



Flag Track Defective will flag (in the case of the ISS) a single track defective or (in the 
case of a 7900) one cylinder (48 sectors) will be flagged. 



DELAY TIME: 



The default interrupt time out is 300 milliseconds. 



EXAMPLE: 



> 10 DEV 0,5,13,20,0 

> 10 SEEK 0,100,0,0 

> 20 FTD 0,100,0,0 

> 30 END 

> 40 RUN 

> 40 



The above example flags that a track is defective starting at cylinder 100 on a 7900 
Disc. 
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FLAG TRACK DEFECTIVE IMMEDIATE FTDI 

Flags a defective disc. 



FORMAL NAME: 



FLAG TRACK DEFECTIVE IMMEDIATE 



SYNTAX: 



> FTDI lun 



PARAMETER: 



lun 



Logical unit number. 



OPERATION: 



Flag Track Defective Immediate will flag, for a 7900 a cylinder (48 sectors), for an ISS 
one track, defective. In either case the internal disc address will be used as the starting 
address. 



DELAY TIME: 


Default interrupt time out L 


EXAMPLE: 


> 10 DEV 0,5,13,100,0 




> 10 SEEK 0,50,0,0 




> 20 FTDI 




> 30 END 




> 40 RUN 




> 40 



The above example uses Flag Track Defective Immediate command to flag that a track 
is defective on a 7900 Disc. 
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FOR 



FOR 



FOR-NEXT loop. 



FORMAL NAME: 



FOR 



SYNTAX: 



> FOR simple variable = initial value TO final value 



PARAMETERS: 



simple variable A letter (A to Z). 

initial value A letter (A-Z) or a letter followed by a number (0-9). 

final value A constant. 



OPERATION: 



FOR allows repeated execution of any number of steps between the FOR and NEXT 
commands. Each FOR must have a NEXT designating the same variable in the pro- 
gram. FOR statements may be nested to 26 (maximum number of variables) levels. 

The first execution of the FOR statement initializes the simple variable to the initial 
value. Each execution of the NEXT command increments the simple variable, by one, 
until it exceeds the final value. 



EXAMPLE: 



DEV 0,5,17,100,0 
DB AA,4096,R 
DB BB,4096,0 
FOR NO TO 511 
WD 0,AA,l,0 
RD 0,BB,l,0 
CB 0,AA,BB,3 
NEXT I 
END 
RUN 



The above example utilizes a FOR loop to execute a sequence of commands. The 
variable I, is used within the loop as the track address parameter for reads and writes 
on a Fixed Head disc. 



> 


10 


> 


10 


> 


10 


> 


10 


> 


20 


> 


30 


> 


40 


> 


50 


> 


60 


> 


70 


> 


70 



R-41 



FORMAT 

Formats a moving head disc. 



FMT 



FORMAL NAME: 


FORMAT 










SYNTAX: 




FMT lun 


,L 

,u 














,Retry 






PARAMETERS: 


lun 
L 
U 
R 






Logical unit number. 
Lower platter. 
Upper platter. 
Error retry count, 0-9. 



7900 Disc only. 



OPERATION: 



Format will format a moving head disc. Format will perform a cyclic check or verify of 
the address written. If the LUN is an ISS disc a read and compare of address will also be 
done. 



DELAY TIME: 



Default interrupt time for 7900 and ISS is 500 milliseconds per retry. 



EXAMPLES: 



> 10 DEV 0,5,13,10,0 

> 10 FMTO 

> 20 END 

> 30 RUN 

> 30 



The above example will format both platters of a 7900 Disc. 



> 10 DEV 0,5,13,10,0 

> 10 FMTO.L 

> 20 END 

> 30 RUN 

> 30 



The above example will format the lower platter of a 7900 Disc. 



> 


10 DEV 0,5,14,100,0 


> 


10 NOPR 


> 


20 RC 


> 


30 RC 


> 


40 PR 


> 


50 FMT 


> 


60 END 


> 


70 RUN 


> 


70 



The above example formats an ISS Disc. The recalibrations will clear pack change 
status from changing packs and initial turn on. 
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FSF 



FORWARD SPACE FILE 

Issues a forward space file. 



FORMAL NAME: FORWARD SPACE FILE 



SYNTAX: 



> FSF lun 



PARAMETER: 



lun 



Logical unit number; must be a magnetic tape device. 



OPERATION: 



Forward Space File issues a forward space file SIO program to the tape device specified. 



DELAY TIME: 



The default interrupt delay time is 30 seconds. 



EXAMPLE: 



> 10 DEV 0,6,18,20,0 

> 10 DB AA,4000,R 

> 10 WD 0,AA 

> 20 WFM 

> 30 LOOP 10,10 

> 40 REW 

> 50 FSF 

> 60 LOOP 50,9 

> 70 END 

> 80 RUN 

> 80 



The above example writes 11 records of random data with a file mark after each, 
rewinds the tape, then forward spaces to 10 of them. 
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FORWARD SPACE RECORD 

Issues a forward space record. 



FSR 



FORMAL NAME: 



FORWARD SPACE RECORD 



SYNTAX: 



> FSR lun 



PARAMETER: 



lun 



Logical unit number; must be a magnetic tape device. 



OPERATION: 



Forward Space Record will issue a forward space record SIO program to the specified 
magnetic tape device. 



DELAY TIME: 



The default interrupt time out is 10 seconds. 



EXAMPLE: 



> 10 DEV 0,6,18,30,0 

> 10 DB AA,8000,R 

> 10 WD 0,AA 

> 20 LOOP 10,10 

> 30 REW 0, 

> 40 FSR 

> 50 LOOP 40,8 

> 60 REW 

> 70 END 

> 80 RUN 

> 80 



The above example writes II records of random data on tape, rewinds the tape, then 
forward spaces to 9 of them. 
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GAP 



GAP 

Erases magnetic tape. 



FORMAL NAME: GAP 



SYNTAX: 



> GAP lun 



PARAMETER: 



lun 



Logical unit number; must be a magnetic tape device. 



OPERATION: 



GAP will write a GAP on the magnetic tape of the unit specified. 



DELAY TIME: 



The default interrupt time out is 600 milliseconds. 



EXAMPLE: 



> 10 DEV 0,6,18,10,0 

> 10 GAP 

> 20 END 

> 30 RUN 

> 30 



The above example erases a 3 inch portion of magnetic tape using a GAP command. 
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GET 



Obtains information from the operator. 



GET 



FORMAL NAME: 



GET 



SYNTAX 











GET 


var 








lun 


J3 
,T 

,E 
,B 

,u 













PARAMETERS 



The parameter may be a single variable as designated in the var parameter or it may be 
a parameter of the device command. The lun parameter designates which logical unit 
the request is made for. 



D 


- DRT number 


T 


- Type code 


E 


- Error count 


B 


- Baud Rate 


U 


- Unit number 



OPERATION: 



GET will read from the console the PARAMETER indicated. 



EXAMPLE: 



10 PUT "ENTER THE DRT NUMBER" 

20 GET 0,D 

30 PUT "NUMBER OF ERRORS ?" 

40 GET 0,E 

50 PUT "NUMBER OF PASSES ?" 

60 GET A 

70 FOR l= 1 TO A 

80 PUT "EXAMPLE" 

90 NEXT I 



100 END 

110 RUN 
ENTER THE DRT NUMBER 
6 

NUMBER OF ERRORS ? 
10 

NUMBER OF PASSES ? 
3 

EXAMPLE 
EXAMPLE 
EXAMPLE 
> 110 



The above example shows how the GET command may be used to dynamically obtain 
information from the operator. 
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GO 



GO 



Transfers control to line specified. 



FORMAL NAME: 



GO 



SYNTAX: 



> GO stepn, status .mask 



PARAMETERS: 



step n 



status 



mask 



Program will branch to step n. 

Termination target. 

An octal word designating which bits are not to be evaluated. A 
1 bit corresponds to a don't care condition. 



OPERATION: 



Go will branch to the step specified in the stepn parameter until the last TIO or 
interrupt status is equal to the octal status parameter, in which case the branch will be 
defeated. 



EXAMPLE: 



10 DEV 0,6,18,100,0 
10 DB AA, 4096, %1 77777 
10 NAME GG 
10 CONT 0,0 



10 CONT 0,4 
10 WRIT AA,C 
10 JUMP *-2 
10 ENDS 



> 
> 
> 
> 
> 
> 
> 
> 

> 10 SIO 0,GG,0,2,0,%1 77777 

> 20 TIO 0, 

> 30 GO 20,%2000,%1 75777 

> 40 MCO 

> 50 REWO 

> 60 END 

> 70 RUN 

> 70 



The above example writes the entire tape until the end of the tape with ones a pattern. 
This example could be used as a skew check. Tape errors are ignored. 
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(This page intentionally blank) 



5-47A AUG 1977 



GOTO 



FORMAL NAME: 



GOTO 



SYNTAX. 



> GOTO stepN 



PARAMETERS: 



stepN Program will Branch to Step N. 



OPERATION: 



GOTO will Branch to the Step specified in the stepN parameter (unconditional branch). 



EXAMPLE: 



> 10 LETA = 

> 20 GOTO 30 

> 30 LETA = A+l 

> 40 LIST A 

> 50 LOOP 30, 10 

> 60 END 

> 70 RUN 



Program will list through 10 on system console. 



AUG 1977 



5-47B 



HALT 

Performs a halt 9c 17. 



HALT 



FORMAL NAME: 



HALT 



SYNTAX: 



> HALT 



OPERATION: 



Halt will perform a halt %17. Pressing run will restart program execution. 



EXAMPLE: 



> 10 HALT 

> 20 END 

> 30 RUN 

> 30 



The above program executes a halt %17. 
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IF 



IF 

Conditional transfer. 



FORMAL NAME: 



SYNTAX: 



PARAMETERS: 



IF 



> 


IF 


< 


pri 


>< 


relop 


>< 


pri 


> 


THEN 


< 


step 


> 



























< pri > 

< var > 

< constant > 

< relop > 

< step > 



:= < var > | < constant > 

:= A|B|C|. ..|Z 

:= < digit > . . . 

:= =|>|<|<>|>=|< = 

:= target line number. 



OPERATION: 



The IF statement allows conditional transfer of control based on the relation between 
two primaries. If the condition is met, control is transferred to the step specified in the 
step parameter. 



EXAMPLE: 



> 10 DEV 0,5,15,100,0 

> 10 LET A=5 

> 20 SEEK 0,A,0,0 

> 30 LET A=A+5 

> 40 IF A<410 THEN 20 

> 50 END 

> 60 RUN 

> 60 

The above example issues 5 cylinder increment seeks on a 7905 disc. The IF command is 
used to check the bounds of the cylinder address in the variable A. 



0-4y 



INCREMENTAL READ IR 



FORMAL NAME: INCREMENTAL READ 



SYNTAX: 



> IR lun, buff, track, arc 



PARAMETERS: lun Logical unit number; must be a fixed head disc. 

buff Buffer into which data is read. 



track 



arc 



Disc parameters. 



OPERATION: Incremental Read will do a read from the track and arc specified into a buffer. The read 

will continue until the buffer is filled or 128 words has been transferred. Each time this 
command is encountered the arc address will be incremented. 

DELAY TIME: The default interrupt time out is 300 milliseconds. 

EXAMPLE: > 10 DEV 0,5,17,100,0 

> 10 DB AA,128,R 

> 10 DB BB, 128,0 

> 10 IW0,AA,0,0 

> 20 ZBUF BB 

> 30 IR 0,BB,0,0 

> 40 CB 0,AA,BB,3 

> 50 LOOP 10,16383 

> 60 END 

> 70 RUN 

> 70 

The above example shows how Incremental Seek may be used to test a fixed head disc. 
One sector at a time is written then read and compared. 
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IS 



INCREMENTAL SEEK 



FORMAL NAME: 



INCREMENTAL SEEK 



SYNTAX: 



> IS lun[, cylinder, head, sector] 



PARAMETERS: 



lun 

cylinder 
head 
sector 



Logical unit number; must be a moving head disc. 



Disc parameters. 



OPERATION: 



Incremental Seek will do an initial seek to the address specified in the cylinder, head 
and sector parameters. Each time this command is executed it will increment the 
cylinder address. This command updates the Internal Disc Address. Default cylinder, 
head and sector is 0,0,0. 



DELAY TIME: 



The default interrupt time out is 300 milliseconds. 



EXAMPLE: 



> 10 DEV 0,5,13,100,0 

> 10 IS_p_ 

> 20 LOOP 10,2000 

> 30 END 

> 40 RUN 

> 40 



The above example causes a 7900 Disc to execute 1 cylinder Increment Seeks. 
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INCREMENTAL TRACK IT 



FORMAL NAME: INCREMENTAL TRACK 



SYNTAX: 



> IT lun[ , cylinder, head, sector] 



PARAMETERS: lun Logical unit number; must be a moving head disc. 

cylinder 

Disc parameters. 




OPERATION: Incremental Track will do an initial seek to the location specified in the cylinder, head 

and sector parameters. It will increment the head address by 1 until 19 (for ISS) or 3 (for 
7900) then the next increment will proceed to the next cylinder. If cylinder = 405 (for 
ISS) or 203 (for 7900) the command will seek to and start over. This command updates 
the Internal Disc Address. 

DELAY TIME: The default interrupt time out is 300 milliseconds. 

EXAMPLE: > 10 DEV 0.7.14,100.0 

> 10 DB AA,2944,W 

> 1 28 (%1 25252), 1 28(%52525), 1 28(%1 77777), 1 28(0), 1 28(%22222), 1 28(%1 1111) 

> 10 DB BB.2944.0 

> 10 IT 

> 20 WDI O.AA 

> 30 CCI 0,23 

> 40 ZBUF BB 

> 50 RDI O.BB 

> 60 CB 0,AA,BB,5 

> 70 LOOP 10,8119 

> 80 END 

> 90 RUN 

> 90 

The above example indicates how Increment Track may be used to create tests on an 
ISS Disc. Each track is written with the patterns in buffer A A, cyclic checked then the 
data is read and compared. 
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IW 



INCREMENTAL WRITE 



FORMAL NAME: 



INCREMENTAL WRITE 



SYNTAX: 



PARAMETERS: 



> 



IW lun, buff, track, arc 



lun 
buff 
track 
arc 



Logical unit number; must be a fixed head disc. 
Buffer into which data is written. 

Disc parameters. 



OPERATION: 



Incremental Write will do a write to the track and ARC specified. The write will 
continue until the buffer is exhausted or the word count reaches 128. Each time this 
command is encountered the ARC Address will be incremented. 



DELAY TIME: 



The default interrupt time out is 300 milliseconds. 



EXAMPLE: 



> 


10 DEV 0,5,17,50,0 


> 


10 DB AA,128,%666666 


> 


10 DB BB, 128,%1 77777 


> 


10 DB CC,128,%1 25252 


> 


10 DB DD,128,%52525 


> 


10 DB EE,128,0 


> 


10 IW 0,AA,0,0 


> 


20 IR 0,EE,0,0 


> 


30 CB 0,AA,EE,3 


> 


40 IW 0,BB,0,0 


> 


50 IR 0,EE,0,0 


> 


60 CB 0,BB,EE,3 


> 


70 IW 0,CC,0,0 


> 


80 IR 0,EE,0,0 


> 


90 CB 0,CC,EE,3 


> 


100 IW0,DD,0,0 


> 


110 IR0,EE,0,0 


> 


120 CB 0,DD,EE,3 


> 


130 LOOP 10,16383 


> 


140 END 


> 


150 RUN 


> 


150 



The above example uses Incremental Write to check a fixed head disc. Four different 
patterns are written and each pattern is read and checked. 
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INITIALIZE DATA 



Initializes device 



ID 



FORMAL NAME: 



INITIALIZE DATA 



SYNTAX 



> ID lun,buf [, cylinder, head,sector] 

> ID lun,buf [,mask[,flag[ cylinder, head, sector]]] 



Format 
1 
2 



PARAMETERS: 



lun 



buf 



cylinder 

head 

sector 



flag 



mask 



Logical unit number; must be a 7900 (format 1) or 7905 (format 
2) disc. 

Buffer into which data is read. 

Disc parameters indicating starting location of initialization 
operation. The heads are assumed to be positioned over the 
correct cylinder. 

Flags the track as: 

S - Spare 

P - Protected 

D - Defective 

N - Non-flagged 

Loads file mask on controller. The mask bits are: 



Bits Function 

8-11 Number of retries allowed. 

12 Incremental/Decremental Seek. If set and bit 15 is a 1, the cylinder 
address will be decremented when End-of-Cylinder; otherwise, 
incremented. 

13 Allow sparing. 

14 Cylinder/Surface mode. If set, a cylinder consists of all available 
surfaces; End-of-Cylinder is set when the last sector of the last 
surface has been transferred. In surface mode, End-of-Cylinder is 
set when the last sector of any surface has been transferred. 

15 Allow Incremental/Decremental seek. 

Default mask is cylinder mode. Default flag is non-flagged. Default cylinder, head, and 
sector is 0,0,0. 
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ID INITIALIZES DEVICE 



Continued 



OPERATION: Initialize Data will perform an initialize operation on a 7900 or 7905 disc. The initialize 

operation will begin at the cylinder, head, and sector designated and will continue until 
the word count of the buffer is exhausted. 

DELAY TIME: The default interrupt time out is 500 milliseconds. 

EXAMPLE: > 10 DEV 0,5,15,100,0 

> 10 DB AA,6144,0 

> 10 SEEK 0,10,0,0 

> 20 ID 0,AA,3,D,400,0,0 

> 30 SEEK 0,400,0,0 

> 40 ID 0,AA,3,S,10,0,0 

> 50 SEEK 0,10,0,0 

> 60 RDI 0,AA,7 

> 70 LOOP 60,10 

> 80 END 

> 90 RUN 

> 90 

The above example seeks to cylinder 10, initializes the track defective with an alternate 
cylinder address of 400, then seeks to cylinder 400 and initializes the track spare with a 
cylinder address of 10. The program then seeks back to physical cylinder 10 and 
attempts a read operation with sparing enabled. The disc will then automatically seek 
to logical cylinder 10 (400) and read. 
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INITIALIZE DATA IMMEDIATE 



IDI 



FORMAL NAME: 



SYNTAX: 



INITIALIZE DATA IMMEDIATE 



> IDI lun,buf 

> IDI lun,buf [ ,mask[ ,flag]] 



Format 
1 
2 



PARAMETERS 



lun 
buf 
flag 



mask 



Logical unit number; must be a 7900 (format 1) or 7905 (format 
2) disc. 

Buffer into which data is read. Buffer length determines word 
count of the write. 

Flags the track as: 

S - Spare 

P - Protected 

D - Defective 

N - Non-flagged 

Loads file mask on controller. The mask bits are: 



Bits 

8-11 
12 

13 
14 



15 



Function 



Number of retries allowed. 



Incremental/Decremental Seek. If set and bit 15 is a 1, the cylinder 
address will be decremented when End-of-Cylinder; otherwise, 
incremented. 

Allow sparing. 

Cylinder/Surface mode. If set, a cylinder consists of all available 
surfaces; End-of-Cylinder is set when the last sector of the last 
surface has been transferred. In surface mode, End-of-Cylinder is 
set when the last sector of any surface has been transferred. 

Allow Incremental/Decremental seek. 



Default flag is non-flagged. Default cylinder, head, and sector is 0,0,0. 



OPERATION: 



Initialize Data Immediate will perform an initialize operation on a 7900 or 7905 disc. 
The Internal Disc Address will be used as the starting point of the write. 



DELAY TIME: 



The default interrupt time out is 500 milliseconds. 



EXAMPLE: 



> 10 DEV 0,5,15,100,0 

> 10 DB AA,6144,0 

> 10 ISO 

> 20 IDI 0,AA 

> 30 IS 0,0,1,0 

> 40 IDI 0,AA 

> 50 LOOP 10,410 

> 60 END 

> 70 RUN 

> 70 



The above example formats the upper cartridge on a 7905 disc. 
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INT 



INTERRUPT 

Places an interrupt order in an SIO chain. 



FORMAL NAME: 



INTERRUPT 



SYNTAX: 



> INT 



OPERATION: 



Interrupt will place an interrupt order in an SIO chain (see SIO and NAME commands). 



EXAMPLE: 



> 10 DEV 0,6,24,10,0 

> 10 NAME IN 

> 10 INJ 

> 10 ENDS 

> 10 SIO O.IN.1,2,%100000,%77777 

> 20 END 

> 30 RUN 

> 30 



The above example uses an interrupt order to generate an interrupt from magnetic 
tape. 



JUMP JUMP 

Places a jump order in an SIO chain. 



FORMAL NAME: JUMP 



SYNTAX: 



> JUMP addressj ,C] 



PARAMETERS: address Self-relative address which to jump. 

[ C] Specifies a conditional jump. 

OPERATION: Jump will place a Jump Order in an SIO chain. (See NAME and SIO commands.) 

EXAMPLE: 



> 


10 DEV 0,5,13,10,0 


> 


10 DBAA,3072,%1 77777 


> 


10 NAME DF 


> 


10 CONT0,%1 00000 


> 


10 WRIT AA 


> 


10 JUMP*- 4 


> 


10 ENDS 


> 


10 SEEK0 


> 


20 SIO 0,DF,0,2,0,%1 77777 


> 


30 HALT 


> 


40 END 


> 


50 RUN 


> 


50 



The above example shows how a Jump command may be used. The program causes the 
continual transfer of data to a 7900 Disc. The CPU halts but the I/O system remains 
active. 
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LET 



LET 

Assignment command. 



FORMAL NAME: 



SYNTAX: 



PARAMETERS: 



LET 



> LET <var> = < expr> 



< expr> 

< primary > 

< uar> 
< constant > 
<uop> 

<op> 



: := <primary> <op> <expr>\<uop> <expr>\TIO\(<expr>) 
: := <var> \ <constant> 
: := A|B|C|. . .|Z 
: := <digit> . . . 
: := NOT 

H-l-i 
: := lsl|lsr|asl|asr|csl|csr|*|/|mod!+|and|xor|or 



OPERATION: 



Let allows the execution of arithmetic and logical operations on constants and variabl- 
es. An expression defines a sequence of arithmetic or logical operations which result in 
a single value. A variable can be any single alpha digit from A to Z. A constant may be a 
decimal or octal value in the range of to % 177777. The reserved word TIO defines the 
last TIO status from any device. The order of precedence is: 



Rank 1 
Rank 2 
Rank 3 
Rank 4 
Rank 5 
Rank 6 
Rank 7 



Any expression in parentheses. NOT (unary one's complement). 

All shift operators. 

Multiply, divide and modulo operators. 

Addition and subtraction operators. 

Logical and operator. 

Logical exclusive - or operator. 

Logical or operator. 



EXAMPLE: 



> 10 LET A= 100 

> 20 LET B=A*(A MOD 99) 

> 30 LET C= B+ 1 

> 40 LET D=B LSR(2) 

> 50 END 

> 60 RUN 

> 60 DUMP V 
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LET LET 



Continued 



LET EXAMPLE: 



A 


= 100 


B 


= 100 


C 


= 101 


D 


= 25 


E 





F 





G 





H 





1 





J 





K 





L 





M 





N 











P 





Q 





R 





S 





T 





U 





V 





w 





X 





Y 





z 






> 60 
The above example shows the use of the LET command as an assignment operator. 
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LIST 

Display contents on console. 



FORMAL NAME: 



LIST 



SYNTAX: 



PARAMETERS: 



> LIST var[ ,base\ 



base 



A letter (A to Z). 

Base (8 or 10) the output value will appear in. 



OPERATION: 



List will list on the console the contents of a designated variable. 



EXAMPLE: 



> 10 RAND I 

> 20 LIST I 

> 30 LIST 1,8 

> 40 END 

> 50 RUN 
20275 

%47463 

> 50 

The above example generates a random value in the variable I. The List command is 
used to display the contents of the variable. 
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LOAD TIO REGISTER 

Loads TIO Register. 



LTIO 



FORMAL NAME: LOAD TIO REGISTER 



SYNTAX: 



PARAMETERS: 



> LTIO lun,word 



lun 
word 



Logical unit number. 

Word to be loaded into the TIO register. 



OPERATION: 



Load TIO Register will load bits 3-15 of the value in the WORD parameter into the TIO 
register on the 7905 interface. 



DELAY TIME: 



The default interrupt time out is 300 milliseconds. 



EXAMPLE: 



> 10 DEV 0,5,15,100,0 

> 10 LTIO 0,%525 

> 20 TIO 

> 30 STAT T 

> 40 END 

> 50 RUN 

D3 last TIO status is 1 000 000 101 010 101 

> 50 

The above example loads the TIO register on the 7905 controller. The TIO status is then 
obtained and displayed. 



5-62 



LOOP 



LOOP 



Unconditional branch. 



FORMAL NAME: 



LOOP 



SYNTAX: 



> LOOP stepn,count 



PARAMETERS: 



stepn 



count 



Unconditional branch to step "n". 

Number of times (decimal) execution will loop. 



OPERATION: 



Loop will perform an unconditional branch to the stepnumber specified until this 
command has been executed the number of times specified in the "COUNT" parameter. 



EXAMPLE: 



> 10 DEV 0,5,14,20,0 

> 10 DB AA, 128, 123 

> 10 RS 

> 20 WDI O.AA 

> 30 LOOP 10,1000 

> 40 END 

> 50 RUN 

> 50 

The above example uses the Loop Command to execute a sequence of commands 1001 
times. 
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MAKE TEST TAPE MAKT 

Makes a test tape. 



FORMAL NAME: MAKE TEST TAPE 



SYNTAX: 


> MAKT 


M 


PARAMETERS: 


A 

N 





Appends a tape onto an existing test tape. 
New tape. 

OPERATION: Make Tape will make a test tape. A test tape is a SLEUTH made tape consisting of user 

programs. The N parameter indicates this is a new tape. The A parameter will append a 
test onto an existing test tape. The current program will only be dumped if an END 
statement exists in the program. The tape unit must be mounted on DRT 6 unit 0. Only 
SLEUTH can interpret this tape. (See BA command.) 

EXAMPLE: > 10 DEV 0,5,13,50,0 

> 10 DBAA,128,%1 77777 

> 10 RS 

> 20 WDI 0,AA 



> 30 LOOP 10,10 

> 40 END 

> 50 MAKT N 

> 50 

The above example will make a test tape of the above program. 
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MC 



MASTER CLEAR 

Master Clears device. 



FORMAL NAME: MASTER CLEAR 



SYNTAX: 



> MC lun 



PARAMETER: 



lun 



Logical unit number. 



OPERATION: 



Master Clear will Master Clear the LUN specified. 



EXAMPLE: 



> 10 DEV 0,6,24,100,0 

> 10 MC 

> 20 END 

> 30 RUN 

> 30 

The above example will send a Master Clear to the device. 
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NAME SIO PROGRAM NAME 

Names a program. 



FORMAL NAME: NAME SIO PROGRAM 



SYNTAX: 



> NAME sioprog 



PARAMETER: sioprog Two character name of an SIO program. 

OPERATION: Name will allocate space for an SIO program. Immediately following the Name com- 

mand only the SIO command will be acceptable until an ENDS command is entered. 

EXAMPLE: 



> 


10 DEV 0,5,23,10,0 


> 


10 DB AA,100,S 


> 


THIS IS A STRING BUFFER 


> 


10 NAME J J 


> 


10 CONT%456,%123 


> 


10 SENS 


> 


10 INT 


> 


10 READ AA,C 


> 


10 READ AA 


> 


10 WRIT AA,C 


> 


10 WRIT AA 


> 


10 JUMP *-7 


> 


10 ENDS 


> 


10 DUMP S,JJ 



177777 20000 17777 177634 36307 
36307 67634 36307 35511 



The above example indicates how an SIO program may be defined using the Name 
command. The example shows the various combinations of SIO order pairs. 



35502: 


40456 


123 50000 


35512: 


77634 


36307 167634 


35522: 


30000 


1 77777 


> 10 







5-66 



NEXT NEXT 



Terminates a For Iood. 



FORMAL NAME: NEXT 

SYNTAX: 



> NEXT var 



PARAMETER: var A letter (A to Z). 

OPERATION: NEXT terminates a FOR loop. Each execution of the NEXT command increments the 

indicated variable by one. If the variable has not exceeded its maximum count control is 
transferred to the command immediately following the FOR command; otherwise, 
control is transferred to the command following the NEXT. (See FOR command.) 

EXAMPLE: > 10 DEV 0,5,15,100,0 

> 10 FOR Z=0 TO 410 

> 20 SEEK 0,Z,0,0 

> 30 NEXT Z 

> 60 END 

> 50 RUN 

> 50 

The above example used the NEXT command to terminate a FOR loop. 



NO PRINT 

Suppresses messages. 



NOPR 



FORMAL NAME: 



NO PRINT 



SYNTAX: 



OPERATION: 



> NOPR 



The No Print command will cause the suppression of all messages except User- 
SLEUTH dialogue. No Print also disables halt on error. 



EXAMPLE: 



> 10 DEV 0,14,14,5,0 

> 10 NOPR 

> 20 RC 

> 30 RC 

> 40 PR 

> 50 END 

> 60 RUN 

> 60 

The above example uses the No Print command to turn off all messages except user 
dialogue. 
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PCT 



PACK CERTIFICATION 

Performs a pack certification test on disc. 



FORMAL NAME: 



PACK CERTIFICATION 



SYNTAX: 



PARAMETERS: 



> PCT lun,pattern 



lun 
pattern 



Logical unit number; must be an ISS disc. 
Octal test pattern. 



OPERATION: 



Pack Certification will execute a PCT on the ISS disc indicated. One track, wherever 
the heads are positioned will be certified using the octal pattern. 



DELAY TIME: 



The default interrupt time out is 300 milliseconds. 



EXAMPLE: 



> 10 DEV 0,7,14,30,0 

> 10 ITO 

> 20 PCT 0,%1 25252 

> 30 LOOP 10,8119 

> 40 END 

> 50 RUN 

> 50 

The above program performs a pack certification test on the entire disc pack using the 
octal pattern 125252. 
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PAUSE ON ERROR 



PE 



Pause on error. 



FORMAL NAME: 



PAUSE ON ERROR 



SYNTAX: 



> PE 



OPERATION: 



Pause On Error will execute a halt % 16 if an error is encountered. It will not be enacted 
if no print is in effect. 



EXAMPLE: 



> 10 DEV 0,5,13,5,0 

> 10 PE 

> 20 RS 

> 30 LOOP 20,9999 

> 40 END 

> 50 RUN 

> 50 



The above program sets the Pause On Error option using the PE command. 
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POLL 



POLL 

Resumes polling. 



FORMAL NAME: 



POLL 



SYNTAX: 



> POLL lun 



PARAMETER: 



lun 



Logical unit number. 



OPERATION: 



Poll causes the 7905 disc controller to resume polling. 



DELAY TIME: 



The default interrupt time out is 300 milliseconds. 



EXAMPLE: 



> 10 DEV 0,5,15,100,0 

> 10 POLL0 

> 20 END 

> 30 RUN 

> 30 

The above example issues the Poll command to the 7905 disc. 
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PRINT PR 

Resume message printing. 



FORMAL NAME: PRINT 



SYNTAX: 



> PR 



OPERATION: Print will cause the resumption of all message output that was suppressed by the NOPR 

command. Pause on error (if selected) is re-enabled. 

EXAMPLE: > 10 DEV 0,5,14,100,0 

> 10 NOPR 

> 20 RC 

> 30 RCO 

> 40 PR 

> 50 

The above example turns off the Print at step 10, performs two recalibrated operations 
on an ISS Disc, then turns on the Print at step 40 using the PR command. 
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PROC PROCEED 



FORMAL NAME: PROCEED 



SYNTAX: 



> PROC [f 



PARAMETERS: [ N] Cancels proceed mode. 

[ D] Causes direct I/O interference to each device executing in pro- 

ceed mode. 

OPERATION: Proceed will cause SLEUTH to go into the asynchronous mode of operation. PROC N 

should be placed before the last command to be executed in proceed mode. 

EXAMPLES: > 10 DEV 0,8,14,25,2 

> 10 DEV 1,6,19,25,0 

> 10 DB AA,800Q,R 

> 10 NOPR 

> 20 RC 

> 30 RC 

> 40 PR 

> 50 PROC 

> 60 SEEK 

> 70 WD 1 ,AA 

> 80 WD I 0,AA 

> 90 LOOP 70,100 

> 100 REW 1 

> 110 END 

> 120 RUN 

> 120 

The above example writes an 8000 word buffer of random data on mag tape and an ISS 
Disc. The proceed mode is used to overlap the writes. 

> 10 DEV 0,7,14,20,0 

> 10 DEV 1,8,14,20,0 

> 10 DB AA,8000,R 

> 10 NOPR 

> 20 RC 

> 30 RC 1 

> 40 RC 

> 50 RC 1 

> 60 PR 

> 70 PROC 

> 80 SEEK 

> 90 SEEK 1 

> 100 WDI O.AA 

> 110 WDI 1.AA 

> 120 LOOP 100,100 

> 130 END 

> 140 RUN 

> 140 

The above example writes an 8000 word buffer of random data on two ISS Discs. The 
proceed mode is used to overlap the writes. 
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PUT 

Prints message. 



PUT 



FORMAL NAME: PUT 



SYNTAX: 



> PUT "string" 



PARAMETER: 



'string" 



0-72 characters enclosed by quotation marks. 



OPERATION: 



PUT will print a message on the console. The message will be contained within quotes. 



EXAMPLE: 



> 10 PUT "THIS IS AN EXAMPLE" 

> 20 END 

> 30 RUN 

THIS IS AN EXAMPLE 

> 30 



The above example utilizes the PUT command to output a string on the console. 
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RAND RANDOMIZE 



Generates a random number. 



FORMAL NAME: RANDOMIZE 



SYNTAX: 



> RAND var 



PARAMETER: var A letter (A to Z). 

OPERATION: Randomize generates a positive random number and places it in the variable 

designated. 



WARNING 



SLEUTH does not produce true random data. Bit 15 is al- 
ways high. 



EXAMPLE: 


> 10 RAND A 

> 20 RAND B 

> 30 RAND C 

> 40 END 

> 50 RUN 

> 50 DUMP V 








A 


= 


19139 




B 


= 


7209 




C 


= 


16117 




D 


= 







E 


= 







F 


— 







G 


= 







H 


= 







I 


= 







J 


= 







K 


= 







L 


= 







M 


= 







N 


= 







O 


= 







P 


= 







Q 


= 







R 


= 







S 


= 







T 


= 







U 


= 







V 


— 







w 


= 







X 


= 







Y 


= 







z 


= 






> 50 
The above example Randomizes 3 variables. 
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RANDOM SEEK 

Issues a random seek command to the disc. 



RS 



FORMAL NAME: 



RANDOM SEEK 



SYNTAX: 



> RS lun 



PARAMETER: 



lun 



Logical unit number; must be a moving head disc. 



OPERATION: 



Random Seek will issue a Random Seek command to the LUN designated. This instruc- 
tion updates the internal disc address. 



DELAY TIME: 



The default Interrupt time out is 300 milliseconds. 



EXAMPLE: 



> 10 DEV 0,7,14,10,0 

> 10 RS 

> 20 LOOP 10,5000 

> 30 END 

> 40 RUN 

> 40 



The above example executes 5001 Random Seek operation on an ISS Disc. 
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READ 



READ 



Places a read order in an SIO chain. 



FORMAL NAME: 



READ 



SYNTAX: 



> READ fa<f [,C] 



PARAMETERS: 



buf 



Buffer into which data is read. Buffer length (4k max.) deter- 
mines word count of the read. 



[C] 



Specifies a chain read. 



OPERATION: 



Read will place a read order in an SIO chain. 



EXAMPLE: 



> 10 DEV 0.8,14,5,0 

> 10 DB AA,128,%12345 

> 10 DB XX,128,0 

> 10 NAME RD 

> 10 CONT 0,%50000 

> 10 READ XX 

> 10 ENDS,! 

> 10 SEEKO 

> 20 WD I 0,AA 

> 30 SIO 0,RD,1,3,%1 70000,0 

> 40 CB 0,AA,XX,5 

> 50 END 

> 60 RUN 

> 60 



The above example uses the Read SIO order to read 1 sector from an ISS disc. 
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READ ADDRESS 

Performs a read address. 



RA 



FORMAL NAME: 



READ ADDRESS 



SYNTAX: 



PARAMETERS: 



> RA lun [, cylinder, head, sector] 



lun 

cylinder 

head 

sector 



Logical unit number; must be an ISS Disc. 



Disc parameters. 



OPERATION: 



Read Address performs a Read Address operation on the LUN indicated. The read will 
take place on the cylinder and head specified. The heads are assumed to be over the 
correct cylinder. Default cylinder, head, and sector is 0,0,0. 

NOTE 

Only the cylinder and head address are valid on an RA. 



DELAY TIME: 



The default interrupt time out is 300 milliseconds. 



EXAMPLE: 



> DEV 0,7,14,3,1 

> 10 SEEK 0,124,3,3 

> 20 RA 0,124,3,3 

> 30 CAP 

> 40 END 

> 50 RUN 

> 50 

The above example reads a singular address from cylinder 124, head 3. Then uses the 
CA command to check the cylinder and head of the Address Read. 



5-78 



RAI 



READ ADDRESS IMMEDIATE 

Performs a Read Address Immediate. 



FORMAL NAME: 



READ ADDRESS IMMEDIATE 



SYNTAX: 



> RAI lun 



PARAMETER: 



lun 



Logical unit number; must be an ISS Disc. 



OPERATION: 



Read Address Immediate performs a Read Address on an ISS Disc. The Internal Disc 
Address will be used as the address where the operation will take place. 



DELAY TIME: 



The default Interrupt Time out is 300 milliseconds. 



EXAMPLE: 



> 10 DEV 0,8,14,5,0 

> 10 RS 

> 20 RAI 

> 30 CAP 

> 40 LOOP 10.500 

> 50 END 

> 60 RUN 

> 60 

The above example randomly seeks and reads addresses. The cylinder and head portion 
of each address is then checked. 
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READ CLOCK 

Reads elapsed time. 



RCLK 



FORMAL NAME: 



READ CLOCK 



SYNTAX: 



> RCLK var 



PARAMETER: 



A letter (A to Z). 



OPERATION: 



Read Clock reads the process clock in the CPU into the variable designated. 



EXAMPLE: 



> 10 DEV 0,5,13,100,0 

> 10 SCLK 

> 20 RS 

> 30 LOOP 20,100 

> 40 RCLK A 

> 50 LET A=A+A/1000 

> 60 PUT "ELAPSED TIME IN MILLISECONDS IS' 

> 70 LIST A 

> 80 END 

> 90 RUN 

ELAPSED TIME IN MILLISECONDS IS 
2668 

> 90 



The above example loads the process clock with 0, executes 101 random seeks then 
reads the process clock. Since the process clock counts at a rate of 1.001 milliseconds the 
value in the variable a is modified to reflect the true elapsed time in milliseconds. 
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RD 



READ DATA 



Reads devices. 



FORMAL NAME: 



SYNTAX: 



READ DATA 



OPERATION: 



> RD lun,buf\ ,cy Under, head, sector] 

> RD lun,buf[ ,mask[ , cylinder, head,sector]] 

> RD lun,buf\_ , track , arc] 

> RD lun,buf,mode 

> RD lun,buf 

> RD lun,buf, [ mode [ ,hopper [ ,stacker]]] 



Format 
1 
2 
3 
4 
5 



Read Data will perform a read operation on the lun indicated. Due to the variance of 
readable devices, six discrete formats are required. 

Format 1: Will be utilized with ISS and 7900 discs. The cylinder, head, sector parame- 
ters will designate the starting point of the read. Default is 0,0,0. 



Format 2: Will be used on the 7905 disc. The file mask on the controller will be set 
with the value is the mask parameter. Default is cylinder mode. See Set File Mask 
(SFM) command for the mask format. The cylinder, head, sector, parameters will 
designate the starting point of the read. Default is 0,0,0. 



Format 3: Will be used with fixed head discs. The track, arc parameters will indicate 
the starting point of the read. 



Format 4: Will be utilized with Card Readers, SEL CHAN MAINT Cards and Paper 
Tape Readers. The mode parameter will be one of the following: 

• Paper Tape 

W - Work Transfer Mode 
B - Byte Transfer Mode 



Card Reader 



A 
P 
C 



ASCII 

Packed Binary 
Column Binary 



SEL CHAN MAINT Card 

F - Fast Request Mode 
S - Slow Request Mode 



Format 5: Will be used with Magnetic Tape and devices attached to the Asynchronous 
Multiplexor. 

If reading from devices attached to the Asynchronous Multiplexor a carriage return 
may terminate the read, otherwise the buffer's length determines the word count of the 
read. 



READ DATA 

Continued 



RD 



Format 6: Will be used on the Reader/Interpreter/Punch. The mode parameter can be 
one of the following: 

C - Column Binary 
H - Hollerith 

Default is Hollerith to ASCII conversion. The hopper/ stacker parameters may be the 
following: 

P - Primary hopper/ stacker 
S - Secondary hopper/ stacker 

Default hopper/ stacker parameters are secondary. 



DELAY TIMES: 



The following are default interrupt times out: 



Device 

Disc 

Magnetic Tape 
Asynchronous Multiplexor 
Card Reader 
Paper Tape 
Reader/Punch 



Time Out 

300 Milliseconds 

5 Seconds 
50 Seconds/Per Character 

3 Seconds 
30 Seconds 

7 Seconds 
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RD READ DATA 



Continued 



EXAMPLES: 



> 


10 DEV 0,22,10,100,0 


> 


10 DB AA,40,0 


> 


10 DB BB,40,0 


> 


10 CHB AA,%30060 


> 


20 FOR 1=0 TO 9 


> 


30 RD 0,BB 


> 


40 CB 0,AA,BB,40 


> 


50 CHB AA,I 


> 


60 FOR J= TO 7 


> 


70 CHB AA,S 


> 


80 NEXT J 


> 


90 CHB AA.I 


> 


100 NEXT I 


> 


110 END 


> 


120 RUN 


> 


120 



The above example reads ten cards consisting of Hollerith data from a Reader/Punch. 

> 10 DEV 07,14,30,0 

> 10 DB AA.2944.R 

> 10 DB BB,2944,0 

> 20 WD 0.AA, 150,0,0 

> 30 RD 0,BB,150,0,0 

> 40 CB 0,AA,BB,5 

> 50 END 

> 60 RUN 

> 60 

The above is an example of Read Data on an ISS disc. The program writes one track of 
random data at cylinder 150, head then reads and checks the data. 

> 10 DEV 0,6,18,3,0 

> 10 DB AA,4000,R 

> 10 DB BB,4000,0 

> 10 WD 0,AA 

> 20 REW 

> 30 RD O.BB 

> 40 CB 0,AA,BB,3 

> 50 REW 

> 60 END 

> 70 RUN 

> 70 

The above example indicates how a Read Data operation may be performed on magnetic 
tape. The program writes one 4000 word record on magnetic tape then reads and checks 
the data. 






READ DATA 



Continued 



RD 



EXAMPLES: 



10 DEV 0,10,6,10,1,2400 
10 DB AA,36,0 
10 RD 0,AA,72 
20 END 
30 RUN 



> 

> 

> 

> 

> 

> 

36307 

36317 

36327 

36347 

36347 

> 30 



30 DUMP B,AA 

52110 44523 20111 51440 40516 20105 54101 45520 
46105 20117 43040 51104 20117 47040 52110 42440 
40523 54516 41440 46525 54000 

00000000 





The above example reads characters which were typed in from a device on port 1 of the 
asynchronous multiplexor. 



> 10 DEV 0,7,2,10,0 

> 10 DB AA,60,0 

> 10 RD 0,AA,P 

> 20 END 

> 30 RUN 

> 30 

The above example reads a packed binary card from a card reader into buffer AA. 



10 
10 
10 
10 
10 
20 
30 
30 
15 
30 
30 
30 



DEV 0,7,21,15,0 

DEV 1,8,20,15,0 

DB AA,300,R 

DB BB,300,0 

WD 0,AA,B 

END 

RUN 

10 RD 1.BB 

CB 1,AA,BB,5 

AUTO 30 



RUN 



The above example punches a 300 word buffer on paper tape, then the tape is placed on 
a tape reader, read, and the data is checked. 



> 10 DEV 0,5,17,10,0 

> 10 DB AA, 128,0 

> 10 RD 0,AA,5,3 

> 20 END 

> 30 RUN 

> 30 

The above program reads 128 words from a fixed head disc. 
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RDI 



READ DATA IMMEDIATE 



Reads device. 



FORMAL NAME: 



SYNTAX: 



READ DATA IMMEDIATE 





Format 


> RDI lun,buf 


1 


> RDI lun,buf[, mask] 


2 



PARAMETERS: 



lun 
buf 

mask 



Logical unit number; must be a moving head disc. 

Buffer into which data is read. Length determines word count of 
read. 

Loads file mask on controller. The mask bits are: 



Bits Function 

8-11 Number of retries allowed. 

12 Incremental/Decremental Seek. If set and bit 15 is a 1, the cylinder 
address will be decremented when End-of-Cylinder; otherwise, 
incremented. 

13 Allow sparing. 

14 Cylinder/Surface mode. If set, a cylinder consists of all available 
surfaces; End-of-Cylinder is set when the last sector of the last 
surface has been transferred. In surface mode, End-of-Cylinder is 
set when the last sector of any surface has been transferred. 

15 Allow Incremental/Decremental seek. 



OPERATION: 



Read Data Immediate will perform a read operation on a moving head disc. The 
Internal Disc Address will designate the starting point of the read. Format 1 will 
be used with 7900 and ISS discs. Format 2 will be used with the 7905 disc. The file 
mask on the controller will be loaded with the value specified in the mask 
parameter. (See Set File Mask (SFM) command for mask format.) Default mask is 
cylinder mode. 



DELAY TIME: 



The default interrupt time out is 300 milliseconds. 



EXAMPLE: 



> 10 DEV 0,5,15,100,0 

> 10 DB AA, 128,0 

> 10 DB BB,128,R 

> 10 RSO 

> 20 WDI 0,BB,7 

> 30 RDI 0,AA,7 

> 40 CB 0,BB,AA,3 

> 50 LOOP 10,100 

> 60 END 

> 70 RUN 

> 70 

The above example randomly seeks writes and reads data on a 7905 disc. Sparing 
is enabled. 
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READ FULL SECTOR 

Reads a full sector of a moving head disc. 



RFS 



FORMAL NAME: 



READ FULL SECTOR 



SYNTAX: 



PARAMETERS: 



> RFS lun,buf[ , cylinder, head, sector] 



lun 
buf 

cylinder 

head 

sector 



Logical unit number; must be a moving head disc. 

Buffer into which data is read. Buffer length determines word 
count of read. 



Disc parameters. 



OPERATION: 



Read Full Sector executes a full sector read operation of a moving head disc. The heads 
are assumed to be positioned over the correct cylinder. The default cylinder, head, 
sector is 0,0,0. 



DELAY TIME: 



The default interrupt time out is 300 milliseconds. 



EXAMPLE: 



> 10 DEV 0,5,13,25,0 

> 10 DB AA, 131,%44444 

> 10 DB BB, 131, 

> 10 SEEK 0,150,0,0 

> 20 WFS 0,AA, 150,0,0 

> 30 RFS 0,BB,150,0,0 

> 40 CB 0,AA,BB,3 

> 50 END 

> 60 RUN 

> 60 

The above example uses Read Full Sector to read data from a 7900 Disc. 
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RFSI 



READ FULL SECTOR IMMEDIATE 



Full sector read. 



FORMAL NAME: 



READ FULL SECTOR IMMEDIATE 



SYNTAX: 



> RFSI lun 



PARAMETER: 



lun 



Logical unit number; must be a moving head disc. 



OPERATION: 



Read Full Sector Immediate performs a full sector read operation on a moving head 
disc. The length of the buffer determines the word count of the read. The internal disc 
address will be used for the starting point. 



DELAY TIME: 



The default interrupt time out is 300 milliseconds. 



EXAMPLE: 



> 10 DEV 0,5,13,20,0 

> 10 DB AA, 131, %1 2345 

> 10 DB BB,131,0 

> 10 RS 

> 20 WFSI 0,AA 

> 30 ZBUF BB 

> 40 RFSI 0,BB 

> 50 CB 0,AA,BB,5 

> 60 LOOP 10,200 

> 70 END 

> 80 RUN 

> 80 



The above example issues random seeks to a 7900 Disc, writes and reads full sectors, 
then compares the data. 
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READ MASK 

Read the mask register. 



RMSK 



FORMAL NAME: 


READ MASK 




SYNTAX: 


> RMSK buf 




PARAMETER: 


buf 


E 


OPERATION: 


RMSK will read the m£ 


EXAMPLE: 


> 10 DB AA,1,0 

> 10 RMSK AA 

> 20 END 

> 30 RUN 

> 30 DUMP B,AA 
30600: 400 

> 30 



Buffer into which is read the data. 



The above example reads the mask register into buffer AA and then displays the 
contents of the buffer. 
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RNFS 



READ NEXT FULL SECTOR 



Reads the next full sector. 



FORMAL NAME: 



READ NEXT FULL SECTOR 



SYNTAX: 



> RNFS lun,buf[, cylinder, head, sector] 



PARAMETERS: 



lun 
buf 

cylinder 

head 

sector 



Logical unit numbers; must be an HP 7900 Disc. 

Buffer into which is read the data. Buffer length determines 
word count of the read. 



Disc parameters. 



OPERATION: 



Read Next Full Sector performs a Read Next Full Sector Operation on a 7900 Disc. The 
starting point is specified in the cylinder, head, and sector parameters. Default is 0,0,0. 
The heads are assumed to be positioned over the correct cylinder. 



DELAY TIME: 



The default Interrupt time out is 300 milliseconds. 



EXAMPLE: 



> 10 DEV 0,5,13,10,0 

> 10 DB AA,3144,%1 25252 

> 10 DB BB,128,0 

> 10 SEEK 

> 20 WFSI O.AA 

> 30 RNFS 0,BB 

> 40 CB 0,AA,BB,3 

> 50 END 

> 60 RUN 

> 60 



The above example uses Read Next Full Sector to read the next available full sector 
from cylinder head 0. 
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READ NEXT FULL SECTOR IMMEDIATE RNFI 



Reads the next full sector of a disc. 



FORMAL NAME: 



READ NEXT FULL SECTOR IMMEDIATE 



SYNTAX: 



> RNFI lun, buf 



PARAMETERS: 



lun 
buf 



Logical unit number; must be a 7900 Disc. 
Buffer into which data is read. 



OPERATION: 



Read Next Full Sector Immediate executes a read next full sector operation on the 7900 
Disc. The buffer's length determines the word count of the read. The internal disc 
address will be used as the starting point. 



DELAY TIME: 



The default interrupt time out is 300 milliseconds. 



EXAMPLE: 



> 10 DEV 0,5,13,10,0 

> 10 DB AA,3144,%12345 

> 10 DB BB,131,0 

> 10 SEEK 0,200,0,0 

> 20 WFSI O.AA 

> 30 RNFI O.BB 

> 40 CB 0.AA.BB.3 

> 50 END 

> 60 RUN 

> 60 

The above example uses the Read Next Full Sector Immediate command to read one full 
sector of data from a disc pack. The sector read will be whichever sector the head 
happens to be over when the command is executed. 
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RDC READ RECORD WITH CRCC 



FORMAL NAME: READ RECORD WITH CRCC 



SYNTAX: 



> RDC lun,buf 



PARAMETERS: lun Logical unit number; must be an 800 CPI magnetic tape unit. 

buf Buffer into which data is read. 

OPERATION: Read Record with CRCC will issue a RDC SIO Program to the 800 CPI magnetic tape 

unit. The buffer length determines the length of the record read and should be large 
enough to hold the CRCC. 

DELAY TIME: The default interrupt time out is 5 seconds. 

EXAMPLE: > 10 DEV 0,6,18,10,3 

> 10 DB AA,10,%52525 

> 10 DB BB.11,0 

> 10 WD O.AA 

> 20 REW 

> 30 RDC 0,BB 

> 40 END 

> 50 RUN 

> 50 DUMP B.BB 

36321: 52525 52525 52525 52525 52525 52525 52525 52525 
36331: 52525 52525 4 

> 50 

The above example writes a 10 word buffer of the octal pattern 52525 then reads the 
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buffer. 
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READ WITH OFFSET 



RWO 



FORMAL NAME: 



READ WITH OFFSET 



SYNTAX: 



> RWO lun,buf,mask,offset[ cylinder, head, sector] 



PARAMETERS: 



lun 
buf 

mask 



Logical unit number; must be a 7905 disc. 

Buffer into which data is read. Buffer length determines word 
count of read. 

Loads file mask on 7905 controller. The mask bits are: 



Bits 

8-11 
12 

13 
14 



Function 



15 



Number of retries allowed. 



offset 



Incremental/Decremental Seek. If set and bit 15 is a 1, the cylinder 
address will be decremented when End-of-Cylinder; otherwise, 
incremented. 

Allow sparing. 

Cylinder/Surface mode. If set, a cylinder consists of all available 
surfaces; End-of-Cylinder is set when the last sector of the last 
surface has been transferred. In surface mode, End-of-Cylinder is 
set when the last sector of any surface has been transferred. 

Allow Incremental/Decremental seek. 

Contains cylinder offset and the separator clock information. 




OFFSET WORD FORMAT 

6 7 8 9 10 



A 



D 






23 



CYL OFFSET 



A - Advance 

D - Delay 

S - Sign Bit (OFFSET) 



15 



cylinder 
head 



sector 



Disc parameters; determine starting point of the read. Default is 
0,0,0. 



OPERATION: 



Read With Offset executes like a normal read except an offset word is transmitted to the 
drive before executing. 



DELAY TIME: 



The default interrupt time out is 500 milliseconds. 
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RWOI 



READ WITH OFFSET IMMEDIATE 



FORMAL NAME: 



READ WITH OFFSET IMMEDIATE 



SYNTAX: 



> RWOI lun,buf, mask, offset 



PARAMETERS: 



lun 
buf 

mask 



Logical unit numbers; must be a 7905 Disc. 

Buffer into which data is read. Buffer length determines word 
count of read. 

Loads file mask on 7905 Controller. The mask bits are: 



Bits 

8-11 
12 

13 

14 



Function 



15 



Number of retries allowed. 



offset 



Incremental/Decremental Seek. If set and bit 15 is a 1, the cylinder 
address will be decremented when End-of-Cylinder; otherwise, 
incremented. 

Allow sparing. 

Cylinder/Surface mode. If set, a cylinder consists of all available 
surfaces; End-of-Cylinder is set when the last sector of the last 
surface has been transferred. In surface mode, End-of-Cylinder is 
set when the last sector of any surface has been transferred. 

Allow Incremental/Decremental seek. 

Contains cylinder offset and seperator clock information. 



OFFSET WORD FORMAT 
6 7 8 9 10 



15 




i 

Ot CYL OFFSET 

i 



D 



A - Advance 

D - Delay 

S - Sign Bit (OFFSET) 



OPERATION: 



Read With Offset Immediate executes like a normal read except an offset word is sent to 
the disc before executing. 



DELAY TIME: 



The default interrupt time out is 500 milliseconds. 
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READ WITHOUT VERIFY 



RWV 



FORMAL NAME: 



READ WITHOUT VERIFY 



SYNTAX: 



PARAMETERS: 



> RWV lun,buf '[,mask[, cylinder, head ,sector]] 



lun 
buf 

mask 



Logical unit number; must be a 7905 disc. 

Buffer into which data is read. Buffer length determines word 
count of read. 

Loads file mask on 7905 controller. Default is cylinder mode. 
Mask bits are: 



Bits Function 

8-11 Number of retries allowed. 



12 

13 

14 



15 

cylinder 

head 

sector 



Incremental/Decremental Seek. If set and bit 15 is a 1, the cylinder 
address will be decremented when End-of-Cylinder; otherwise, 
incremented. 

Allow sparing. 

Cylinder/Surface mode. If set, a cylinder consists of all available 
surfaces; End-of-Cylinder is set when the last sector of the last 
surface has been transferred. In surface mode, End-of-Cylinder is 
set when the last sector of any surface has been transferred. 

Allow Incremental/Decremental seek. 



Disc parameters. Indicate starting point of the read. Default is 
0,0,0. 



OPERATION: 



Read Without Verify operates like a normal read operation but does not verify the 
preceding sector. No address checking or sparing operations occur unless a track 
boundary is crossed during the operation. 



DELAY TIME: 



The default interrupt time out is 500 milliseconds. 



EXAMPLE: 



> 10 DEV 0,5,15,100,0 

> 10 DB AA,6144,0 

> 10 FORC=0, TO 410 

> 20 RWV 0,AA,2,C,0,0 

> 30 NEXTC 

> 40 END 

> 50 RUN 

> 50 

The above example uses the Read Without Verify command to read one full surface 
from a 7905 disc. 
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RWVI READ WITHOUT VERIFY IMMEDIATE 



FORMAL NAME: READ WITHOUT VERIFY IMMEDIATE 



SYNTAX: 



> RWVI lun,buf [ ,mask] 



PARAMETERS: lun 

buf 

mask 



Logical unit number; must be a 7905 disc. 

Buffer into which data is read. Buffer length determines word 
count of read. 

Loads file mask on 7905 controller. Default is cylinder mode. 
The mask bits are: 



Bits Function 

8-11 Number of retries allowed. 

12 Incremental/Decremental Seek. If set and bit 15 is a 1, the cylinder 
address will be decremented when End-of-Cylinder; otherwise, 
incremented. 

13 Allow sparing. 

14 Cylinder/Surface mode. If set, a cylinder consists of all available 
surfaces; End-of-Cylinder is set when the last sector of the last 
surface has been transferred. In surface mode, End-of-Cylinder is 
set when the last sector of any surface has been transferred. 

15 Allow Incremental/Decremental seek. 



OPERATION: 



Read Without Verify Immediate operates like a normal read operation but does not 
verify the preceding sector. No address checking or sparing operations occur unless a 
track boundary is crossed during the operation. The starting point of the read will be 
taken from the internal disc address. 



DELAY TIME: 


The default interrupt time o 


EXAMPLE: 


> 10 DEV 0,5,15,100,0 




> 10 DB AA,128,0 

> 10 RS 




> 20 RWVI 0,AA 




> 30 LOOP 10,100 




> 50 RUN 




> 50 



The above example randomly seeks and uses the Read Without Verify Immediate 
command to read one sector of information. 
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RECALIBRATE 



RC 



FORMAL NAME: RECALIBRATE 



SYNTAX: 



> RC lun 



PARAMETER: 



lun 



Logical unit number; must be a moving head disc. 



OPERATION: 



Recalibrate performs a Recalibrate Operation on a moving head disc. 



DELAY TIME: 



The default interrupt time out is 5 seconds. 



EXAMPLE: 



> 


10 DEV 3,7,14,5,0 


> 


10 SEEK 3,405,0,0 


> 
> 


20 RC 3 

30 LOOP 10,100 


> 
> 
> 


40 END 
50 RUN 
50 



The above example seek an ISS Disc to cylinder 405 then recalibrates. The program is 
looped 100 times. 
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REN RENUMBER 



FORMAL NAME: RENUMBER 



SYNTAX: 



> REN 



OPERATION: Renumber will renumber the commands in the program area. The numbering incre- 

ment will range between 10 and 3 depending on the size of the program. If a program is 
being entered and command numbers extend beyond 999 it is desirable to renumber at 
this point. Renumber is also useful if many program edits are made. 

EXAMPLE: 



> 


10 NOPR 


> 


20 PE 


> 


30 PR 


> 


40 5 


> 


35 ES 


> 


40 AUTO 40 


> 


40 DUMP P 




5 SS 




10 NOPR 




20 PE 




30 PR 




35 ES 


> 


40 REN 


> 


60 DUMP P 




10 SS 




22 NOPR 




30 PE 




40 PR 




50 ES 


> 


60 



The above example demonstrates how program renumbering may be accomplished. 
Edits were made to the program then the program was renumbered using the REN 
command. 
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REQUEST DISC ADDRESS 



RDA 



FORMAL NAME: 



REQUEST DISC ADDRESS 



SYNTAX: 



> RDA lun 



PARAMETER: 



lun 



Logical unit number; must be a 7905 disc. 



OPERATION: 



Request Disc Address will return a two word address that can be displayed using the 
DISP command. The RDA command may be used to determine where an error occurred 
during a verify or any other command which terminates with an error. 



DELAY TIME: 



The default interrupt time out is 300 -milliseconds. 



EXAMPLE: 



> 10 DEV 0,5,15,100,0 

> 10 RS 

> 20 RDA 

> 30 DISP 0,D 

> 40 END 

> 50 RUN 



D11 ADDRESS READ IS 66, 3 
> 50 

The above example utilizes the Request Disc Address command to obtain the last 
address from the 7905 disc controller. 



5-98 



RSA 



REQUEST SECTOR ADDRESS 



FORMAL NAME: REQUEST SECTOR ADDRESS 



SYNTAX: 



> RSA lun 



PARAMETER: 



lun 



Logical unit number; must be a 7905 disc. 



OPERATION: 



Request Sector Address returns the logical sector address of the sector currently under 
the heads. This address may be displayed using the DISP command. 



DELAY TIME: 



The default interrupt time out is 300 milliseconds. 



EXAMPLE: 



> 10 DEV 0,5,15,100,0 

> 10 RS 

> 20 RSA 

> 30 DISP 0,S 

> 40 END 

> 50 RUN 

D11 SECTOR ADDRESS IS 20 

> 50 



The above example uses Request Sector Address to obtain the current sector address. 



5-99 



REQUEST STATUS 



RQST 



FORMAL NAME: 



REQUEST STATUS 



SYNTAX: 



> RQST lun 



PARAMETER: 



lun 



Logical unit number. 



OPERATION: 



Request Status will return two words of status from the 7905 disc controller. This status 
may be displayed using the DISP command. The format of the status words are as 
follows: 



1 2 


3 4 5 6 7 8 9 10 1112 


13 14 15 




STATUS -1 


/v y Y V Y Y V\A 




S P D 


TERMINA- 
TION 
STATUS 




UNIT 



STATUS - 2 



STATUS - 1 

The S,P, and D bits reflect the status of the track most recently accessed: 

S = Spare 
P = Protected 
D = Defective 



EXAMPLE: 



> 10 DEV 0,5,15,100,0 

> 10 SEEK 0,10.0.0 

> 20 RQSTO 

> 30 DISP O.R 

> 40 END 

> 50 RUN 

D10 requested status is 
001 111 100 000 000 
000 010 000 100 000 

> 50 

The above example uses the Request Status command to return two words of disc 
status. 



5-100 



RSYN 



REQUEST SYNDROME 



FORMAL NAME: 



REQUEST SYNDROME 



SYNTAX: 



> RSYN lun 



PARAMETER: 



lun 



Logical unit number. 



OPERATION: 



Request Syndrome obtains a 7 word syndrome from the 7905 controller. A Request 
Syndrome operation may be issued after any Read operation which terminates with a 
possibly correctable data error. The 7 words of information will be read into an internal 
buffer which may be displayed with a DISP command. The format of the syndrome 
returned is as follows: 



status 



cylinder 



head sector 



displacement 
PATT 1 
PATT 2 
PATT 3 



Word 
1 
2 
3 
4 
5 
6 
7 
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REQUEST SYNDROME 



Continued 



RSYN 



EXAMPLE: 



10 DEV 0,5,15,100,0 

10 DEV AA,3072,%1 55555 

10 DB BB,3072,0 



10 ITO 

> 20 WDI 0,AA 

> 30 RDI O.BB 

> 40 GO 10,%1 07400,0 

> 50 RSYN 

> 60 DISP 0,Y 

> 70 END 

> 80 RUN 

E2 RDI failed in step 30 
Status is 1 000 111 100 000 000 
Should be 1 000 000 000 000 000 
Cylinder = 379, Sector = 0, Head = 1 
D5 last SIO program executed is 

53017: 40000 7402 40000 6000 67776 101147 40000 2400 

53027: 72000 62273 4000 53021 34000 177777 

D6 SIO program pointer equals 53031 

D9 Last syndrome is 

7400 

573 

420 

1 77774 





1 

> 80 

The above example writes and reads data on a 7905 disc. If a correctable data error is 
detected, the Syndrome is requested and displayed. 
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RUA 



REQUEST UNIT ALLOCATION 



FORMAL NAME: 



REQUEST UNIT ALLOCATION 



SYNTAX: 



> RUA lun 



PARAMETER: 



lun 



Logical unit number. 



OPERATION: 



Request Unit Allocation returns one word of status from the 7905 disc controller. This 
status may be displayed using the DISP command. The format of the status word is as 
follows: 



01 23456789 10 11 


12 13 14 


15 


1 A 


I 


B 



Field Function 

T The T-field specifies on a Bit-per-interface basis what interface 

suffered a time out. 

A The bit in the T-field corresponding to the number in the A-field 

is cleared after the status word is returned. The A-field is the 
number of the interface which issued the RUA command. 

I The I-field indicates the last interface connected to. 

B If set notes that the interface has set the busy bit. 



DELAY TIME: 



The default interrupt time out is 300 milliseconds. 



EXAMPLE: 



> 10 DEV 0,5,15,100,0 

> 10 RUAO 

> 20 DISP 0,1) 

> 30 END 

> 40 RUN 

D12 ALLOCATION STATUS IS 
000 000 1 00 000 000 

> 40 



The above example obtains and displays the Allocation Status. 
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RETURN RESIDUE RRES 



FORMAL NAME: RETURN RESIDUE 



SYNTAX: 



> RRES 



OPERATION: RETURN RESIDUE places a return residue order pair in an SIO chain. (See NAME 

and SIO commands.) 

EXAMPLE: > 10 DEV 0,5,13,25,0 

> 10 DB AA,128,R 

> 10 NAME RR 

> 10 RRES 

> 10 ENDS.I 

> 10 RS 

> 20 WD I 0,AA 

> 30 SIO 0,RR,1,3,%1 10000,0 

> 40 STAT S 

> 50 END 

> 60 RUN 

D5 LAST SIO PROGRAM EXECUTED IS 

35502: 10000 14000 34000 30000 
D6 SIO PROGRAM POINTER EQUALS 35506 

> 60 

The above is an example of Return Residue. The Return Residue was executed after a 
write to a 7900 Disc. 
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REW 



REWIND 



FORMAL NAME: 



REWIND 



SYNTAX: 



> REW lun 



PARAMETER: 



lun 



Logical unit number; must be a magnetic tape unit. 



OPERATION: 



Rewind will issue a rewind command to the magnetic tape unit. 



DELAY TIME: 



The default interrupt time out is 3 minutes. 



EXAMPLE: 



> 10 DEV 0,6,18,10,2 

> 10 DB AA,128,B 

> 10 (%1 23), 1 0(%345), 1 0(%377), 1 0(0), 1 0(5), 1 0(4) 

> 10 WD 0,AA 

> 20 LOOP 10,10 

> 30 REW 

> 40 END 

> 50 RUN 

> 50 



The above example writes eleven 128 word records of data then rewinds the tape unit 
using the REW command. 



K.ins 



REWIND AND RESET 



RST 



FORMAL NAME: REWIND AND RESET 



SYNTAX: 



> RST lun 



PARAMETER: 



lun 



Logical unit number; must be a magnetic tape unit. 



OPERATION: 



Rewind Reset will issue a Rewind Reset command to the magnetic tape unit. 



DELAY TIME: 



The default interrupt time out is 300 milliseconds. 



EXAMPLE: 



> 10 DEV 2,6,18,33,1 

> 10 RST 2 

> 20 END 

> 30 RUN 

> 30 

The above example places the tape unit offline by issuing a Rewind Reset command. 
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RIO RIO 



FORMAL NAME: RIO 



SYNTAX: 


> RIO lun,buf 


PARAMETERS: 


lun 




buf 


OPERATION: 


RIO will issue a read I 



Logical unit number. 

Buffer into which the data is read. 



RIO will issue a read 10 to the LUN specified. The word that is read will be placed in the 
first word of the buffer specified in the BUF parameter. 



EXAMPLE: > 10 DEV 0,127,24,10,0 

> 10 DB AA.1.W 

> 10 (%123) 

> 10 DB BB.1,0 

> 10MC0 

> 20 CIO 0,%377 

> 30 CIO 0,%1 50000 

> 40 CIO 0,%1 70000 

> 50 WIO 0,%123 

> 60 RIO 0, BB, 

> 70 CB 0,AA,BB,1 



> 80 END 

> 90 RUN 

> 90 

The above example indicates how an RIO may be used to test a device. The device used 
was a synchronous single line controller. 
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RIPPLE PRINT 



RP 



FORMAL NAME: 



RIPPLE PRINT 



SYNTAX: 



> RP lun,linelength 



PARAMETERS: 



lun 



linelength 



Logical unit number; must be a lineprinter or a device on the 
Asynchronous MUX. 

Number of columns defining the area of ripple print. 



OPERATION: 



Ripple Print will write a ripple pattern on the LUN indicated. 



DELAY TIME: 



The interrupt time out is as follows: 

Asynchronous MUX - 500 milliseconds/character 
Lineprinter - 4 seconds/line 



EXAMPLES: 



> 10 DEV 0,8,23,100,0 

> 10 RP 0,132 

> 20 END 

> 30 RUN 

> 30 

The above is an example of 132 column Ripple Print on the lineprinter. 

> 10 DEV 0,8,6,100,2,110 

> 10 RP 0,72 

> 20 END 

> 30 RUN 

> 30 

The above is an example of 72 column Ripple Print on the Asynchronous MUX at 110 
Baud Rate. 
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RUN RUN 



FORMAL NAME: RUN 



SYNTAX: 



> RUN 



OPERATION: Run will cause the execution of the previously entered program. Before the program is 

executed SLEUTH ensures all LOOP and GO commands are satisfied. If not, the 
appropriate error message is printed and the program is not executed. 

EXAMPLE: 



> 10 \ 




> 20 1 




> 30 > 


ANY SLEUTH 


> 40 ( 


STATEMENTS 


> 50 / 




> 60 END 

> 70 RUN 




> 70 





The above example illustrates how an END command terminates entering commands 
to the program and how the RUN command causes the program to execute. 
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SEEK SEEK 



FORMAL NAME: SEEK 



SYNTAX: 



> SEEK lun [, cylinder, head, sector] 



PARAMETERS: lun Logical unit number; must be a moving head disc. 

cylinder 

head ^ Disc parameters. 

sector 

OPERATION: Seek will issue a Seek Command to a moving head disc. The SEEK command updates 

the internal disc address. 

DELAY TIME: The default interrupt time out is 300 milliseconds. 

EXAMPLE: 



> 


10 DEV 4,7,14,12,0 


> 
> 


10 SEEK 4 

20 SEEK 4,200,5,23 


> 


30 SEEK 4,405,1,5 


> 


40 LOOP 10,300 


> 
> 
> 


50 END 
60 RUN 
60 



The above program example executes Seek operations on an ISS Disc. The first Seek is 
to cylinder 0, head 0, sector 0. The second Seek is to cylinder 200, head 5, sector 23. The 
last Seek is to cylinder 405, head 1, sector 5. The program then loops 300 times. 
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SKRD 



SEEK READ DATA 



FORMAL NAME: 



SEEK READ DATA 



SYNTAX: 



> SKRD lun,buf [ ,mask [ cylinder, head, sector]] 



PARAMETERS: 



lun 
buf 

mask 



Logical unit number; must be a 7905 disc. 

Buffer into which data is read. Buffer length determines word 
count of the read. 

Loads file mask on controller. Default is the cylinder mode. The 
mask bits are: 



Bits 

8-11 
12 

13 
14 

15 



Function 

Number of retries allowed. 

Incremental/Decremental Seek. If set and bit 15 is a 1, the cylinder 
address will be decremented when End-of-Cylinder; otherwise, 
incremented. 

Allow sparing. 

Cylinder/Surface mode. If set, a cylinder consists of all available 
surfaces; End-of-Cylinder is set when the last sector of the last 
surface has been transferred. In surface mode, End-of-Cylinder is 
set when the last sector of any surface has been transferred. 

Allow Incremental/Decremental seek. 



cylinder 
head 



sector 



Disc parameter; indicate target address of seek- read operation. 
Default is 0,0,0. 



OPERATION: 



Seek Read Data will issue a seek and a read operation within the same SIO program to 
a 7905 disc. 



DELAY TIME: 



The default interrupt time out is 500 milliseconds. 



EXAMPLE: 



> 10 DEV 0,5,15,100,0 

> 10 DB AA, 128,0 

> 10 SKRD 0,AA,2,10,1,2 

> 20 END 

> 30 RUN 

> 30 



The above example uses the Seek Read Data command to read one sector of information 
on the 7905 disc. 
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SEEK WRITE DATA 



SKWD 



FORMAL NAME: 



SEEK WRITE DATA 



SYNTAX: 



> SKWD lun,buf [ ,mask [, cylinder, head, sector]] 



PARAMETERS 



lun 
buf 

mask 



Logical unit number; must be a 7905 disc. 

Buffer into which data is read. Buffer length determines word 
count. 

Loads file mask on controller. Default is cylinder mode. The 
mask bits are: 



Bits 

8-11 
12 



Function 



Number of retries allowed. 



Incremental/Decremental Seek. If set and bit 15 is a 1, the cylinder 
address will be decremented when End-of-Cylinder; otherwise, 
incremented. 



13 Allow sparing. 

14 Cylinder/Surface mode. If set, a cylinder consists of all available 
surfaces; End-of-Cylinder is set when the last sector of the last 
surface has been transferred. In surface mode, End-of-Cylinder is 
set when the last sector of any surface has been transferred. 

15 Allow Incremental/Decremental seek. 



cylinder 
head 



sector 



Disc parameter; indicate target address of seek-write operation. 
Default is 0,0,0. 



OPERATION: 



Seek Write Data will issue a seek and a write operation within the same SIO program 
to a 7905 disc. 



DELAY TIME: 



The default interrupt time out is 300 milliseconds. 



5-112 



SKWD 



EXAMPLE: 


> 


10 DEV 0,5,15,100,0 




> 


10 DB AA,4096,R 




> 


10 DB BB,4096,0 




> 


10 RAND I 




> 


20 LET A= I MOD 409 




> 


30 LET B= I MOD 3 




> 


40 LET C= I MOD 48 




> 


50 SKWD 0,AA,7,A,B,C 




> 


60 SKRD 0,BB,7,A,B,C 




> 


70 GO 100,%1 07400,0 




> 


80 RSYN 




> 


90 DISP 0,Y 




> 


100 CB 0,AA,BB,3 




> 


110 LOOP 10,100 




> 


120 END 




> 


130 RUN 




> 


130 



SEEK WRITE DATA 



Continued 



The above example uses a Seek Write Data command to test a 7905 disc. 
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SELECT UNIT 



SELU 



FORMAL NAME: 



SELECT UNIT 



SYNTAX: 



> SELU lun, unit 



PARAMETERS: 



lun 
unit 



Logical unit number; must be a magnetic tape unit. 

Temporary unit select in the range of to 3. Does not affect the 
logical unit number. The unit does not have to be on-line. 



OPERATION: 



Select Unit will select the unit specified in the UNIT parameter for the LUN indicated. 
The LUN must be defined as a mag tape. 



DELAY TIME: 



The default interrupt time out is 300 milliseconds. 



EXAMPLE: 



> 10 DEV 3,6,18,2,2 

> 10 SELU 3,1 

> 20 END 

> 30 RUN 

> 30 

The above example issues a Select Unit SIO program to the magnetic tape unit. The 
selected unit is 1. 
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SENS SENSE 



FORMAL NAME: SENSE 



SYNTAX: 



> SENS 



OPERATION: Sense will place a Sense order pair in a SIO chain. (See NAME and SIO commands.) 

EXAMPLE: > 10 DEV 0,5,13,23,0 

> 10 NAME SN 

> 10 SENS 

> 10 ENDS,I 



> 10 ENDS,! 

> 10 SIO 0,SN,1,3,%1 10000,0 

> 20 STAT S 

> 30 END 

> 40 RUN 

D5 LAST SIO PROGRAM EXECUTED IS 

35502: 50000 10000 34000 30000 
D6 SIO PROGRAM POINTER EQUALS 35506 

> 40 

The above program issues a Sense SIO order to the disc. The SIO program is then 
displayed. 



SET BANK 



SBNK 



FORMAL NAME: 



SET BANK 



SYNTAX: 



> SBNK bank 



PARAMETER: 



bank 



Specifies bank number. The only bank for SLEUTH operatior 
is 0. 



OPERATION: 



SET BANK places a set bank double word order pair in an SIO program. 



EXAMPLE: 



> 10 DB AA, 128,0 

> 10 NAME SB 

> 10 SBNK 

> 10 WRIT AA 

> 10 ENDS.I 

> 10 DUMP S,SB 
75072: 14000 

> 10 



67600 77136 34000 177777 



The above example uses the Set Bank command in the SIO program. 
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SCLK 



SET CLOCK 



FORMAL NAME: 


SET CLOCK 


SYNTAX: 


> SCLK value 


PARAMETER: 


value 


OPERATION: 


Set Clock loads the 




contained in a varia 


EXAMPLE: 


> 10 SCLK 10 




> 20 RCLK A 




> 30 LIST A,8 




> 40 END 




> 50 RUN 




%12 




> 50 EP,S 




> 10 



Value loaded into the CPU process clock; may be a variable or a 
constant. 



Set Clock loads the process clock in the CPU with the indicated value or the value 



The above example loads the process clock with a value of 10 using the Set Clock 
command. 
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SET ENABLE/DISABLE INTERRUPTS 



SED 



FORMAL NAME: SET ENABLE/DISABLE INTERRUPTS 



SYNTAX: 


> SED 



1 










PARAMETERS: 







1_ 


OPERATION: 


The SED c 


omir 


tand 



Interrupt system is disabled. 
Interrupt system is enabled. 

The SED command enables or disables the interrupt system (status register bit 1). 



WARNING 



Disabling the interrupt system will produce erroneous 
results on most SLEUTH operations. 



EXAMPLE: 


> 


10 DEV 0,15,24,10,0 




> 


10 SED0 




> 


20 MC 




> 


30 CIO 0,%70350 




> 


40 WIO 0,0 




> 


50 CIO 0,%211 




> 


60 WIO 0,%10000 




> 


70 TIO 




> 


80 GO 60,%40,%1 77737 




> 


90 MC0 




> 


100 SED 1 




> 


110 END 




> 


120 RUN 



> 120 

The above example turns off the Interrupt System, then generates an interrupt from a 
clock console board. The interrupt condition is recognized with a test I/O. The condition 
is cleared and the interrupt system re-enabled. 
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SFM 



SET FILE MASK 



FORMAL NAME: 



SYNTAX: 



PARAMETER: 



SET FILE MASK 



> SFM lun,mask 



lun 
mask 



Logical unit number. 

Loads file mask on controller. The mask bits are: 



Bits 

8-11 
12 

13 
14 

15 



Function 

Number of retries allowed. 

Incremental/Decremental Seek. If set and bit 15 is a 1, the cylinder 
address will be decremented when End-of-Cylinder; otherwise, 
incremented. 

Allow sparing. 

Cylinder/Surface mode. If set, a cylinder consists of all available 
surfaces; End-of-Cylinder is set when the last sector of the last 
surface has been transferred. In surface mode, End-of-Cylinder is 
set when the last sector of any surface has been transferred. 

Allow Incremental/Decremental seek. 



OPERATION: 



Set File Mask will set the file mask on the 7905 controller from bits 8-15 of the MASK 
parameter. 



DELAY TIME: 



The default interrupt time out is 300 milliseconds. 



EXAMPLE: 



> 10 DEV 0,5,15,100,0 

> 10 SFM 0,7 

> 20 END 



> 30 RUN 

> 30 

The above example loads the file mask on the 7905 controller with the value 7. 
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SET JUMPERS 



SETJ 



FORMAL NAME: 



SET JUMPERS 



SYNTAX: 



> SETJ lun, jumpers 



PARAMETERS: 



lun 



Logical unit number; must be a Universal Interface with a test 
hood installed. 



jumpers 



Octal number between and 1777 with each bit position corre- 
sponding to a jumper. = reset, 1 = set. The jumper list is: 



BIT 



JUMPER 



15 

14 

13 

12 

11 

10 

9 

8 

7 

6 



Wl 
W2 
W3 
W4 
W5 
W6 
W7 
W8 
W9 
W10 



OPERATION: 



Set Jumpers will Set Jumpers on the Universal Interface Test Hood. 
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SMSK 



SET MASK 



FORMAL NAME: SET MASK 



SYNTAX: 



> SMSK maskword 



PARAMETER: 



maskword 



Octal word used to set the interrupt mask register. 



OPERATION: 



Set Mask will set the interrupt mask register with the octal value designated in the 
Maskword parameter. 



EXAMPLE: 



> 10 SMSK 

> 20 END 

> 30 RUN 

> 30 



The above example issues a Set Mask with the pattern 0. 
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SIN 



SIN 



FORMAL NAME: 



SIN 



SYNTAX: 



> SIN lun 



PARAMETER: 



lun 



Logical unit number. 



OPERATION: 



SIN will issue a Set Interrupt Command to the specified unit. 



DELAY TIME: 



The default interrupt time out is 200 milliseconds. 



EXAMPLE: 



> 10 DEV 4,5,24,12,0 

> 10 SIN 4 

> 20 END 

> 30 RUN 

> 30 



The above example executes a direct set interrupt to the designated device. 
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SIO 



SIO 

Issues SIO program to device. 



FORMAL NAME: 



SIO 



SYNTAX: 



PARAMETERS: 



> SIO lun,sioprog,ints, time, status, mask 



lun 

sioprog 
ints 
time 

status 
mask 



Logical unit number. 

Two letter name of user's SIO program. 

The number of interrupts which the SIO Program will generate. 

The amount of time allowed for the operation in 100 ms. 
increments. 

The expected interrupt status. 

A mask of status don't care bits. = CARE; 1 = DON'T CARE. 



OPERATION: 



SIO will issue a user generated SIO Program to the logical unit specified in the LUN 
parameter. SLEUTH will provide status checking, interrupt evaluation and appropri- 
ate error messages. Up to 16 SIO programs may be declared as long as the total length 
is less than 352 words. To delete an SIO program redefine it. 



EXAMPLE: 



> 10 NAME SI 

> 10 SENS 

> 10 ENDS 

The above example defines an SIO program called SI. 

> 10 NAME SI 

The above example deletes the SIO program. 



o-iza 



SIO SIO 



Continued 



> 


10 DEV 1,6,18,5,0 


> 


10 DB AA.4096,%1 77777 


> 


10 NAME XX 


> 


10CONT 0,%1 00000 


> 


10 WRIT AA 


> 


10 JUMP *-4 


> 


10 ENDS 


> 


10 NAME YY 


> 


10 CONT 0,0 


> 


10 CONT 0,4 


> 


10 WRIT AA,C 


> 


10 JUMP *-2 


> 


10 ENDS 


> 


10 SEEK 


> 


20 SIO 0,XX,0,%177777,%1 77777 


> 


30 SIO 1,YY,0,5,%177777,%1 77777 


> 


40 TIO 1 


> 


50 GO 40,%2000,%1 75777 


> 


60 MC 1 


> 


70 REW 1 


> 


80 LOOP 30,3 


> 


90 MC 


> 


100 MC 1 


> 


110 END 


> 


120 RUN 


> 


120 



The above example builds two SIO programs then issues one to disc and one to tape. 
> 10 DEV 0,5,13,5,0 



> 
> 


10 NAME SK 
10CONT,%100,%20000 


> 
> 


10 ENDS 

10 SIO 0,SK,1,3,%1 0370,0 


> 
> 
> 


20 END 
30 RUN 
30 



The above example builds a seek SIO program and sends it to a disc. 



5-124 



SA 



SKIP ADRESS READ 



FORMAL NAME: 



SKIP ADDRESS READ 



SYNTAX: 



> SA lun,buf[, cylinder, head, sector] 



PARAMETERS: 



lun 
buf 

cylinder 

head 

sector 



Logical unit number. 

Buffer into which the data is read. Buffer's length determines 
the word count of the read. 



Disc parameters. Starting point of the read. The heads are 
assumed to be over the correct cylinder. 



OPERATION: 



Skip Address Read will read the data field without checking the address field. 



DELAY TIME: 



The default interrupt time out is 300 milliseconds. 



EXAMPLE: 



> 10 DEV 0,8,14,5,0 

> 10 

> 10 

> 10 SEEK ,400,0,0 

> 20 

> 30 

> 40 SA 0,BB,400,0,0 

> 50 CB 0,AA,BB,5 

> 60 

> 70 

> 70 



DB AA,2944,R 
DB BB,2944,0 



WA 0,401 ,0,0 
WD 0,AA,401,0,0 



END 
RUN 



The above program writes an invalid address at cylinder 400, then writes data on 
cylinder 400 (which now has the address of cylinder 401) then uses Skip Address Read 
to recover the data off that track. 
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SKIP ADDRESS READ IMMEDIATE 



SAI 



FORMAL NAME: 



SKIP ADDRESS READ IMMEDIATE 



SYNTAX: 



PARAMETERS: 



> SAI lun, buf 



lun 
buf 



Logical unit number; must be an ISS disc. 

Buffer into which data is read. Buffer length determines the 
word count of the read. 



OPERATION: 



Skip Address Read Immediate will read the data field without checking the address 
field. The starting point will be the address contained in the internal disc address. 



DELAY TIME: 



The default interrupt time out is 300 milliseconds. 



EXAMPLE: 



> 10 DEV 0,5,14,30,0 

> 10 DEV 1,6,18,30,0 

> 10 DB AA.2944,0 

> 10 ITO 

> 20 SAI 0,AA 

> 30 WD 1.AA 

> 40 LOOP 10,19 

> 50 END 

> 60 RUN 

> 60 

The above example reads one cylinder of an ISS Disc and transfers it to magnetic tape 
using the Skip Address Read Immediate command. This operation could be used for 
data recovery, should the address fields become unreadable. 
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STAT 



STATUS DUMP 

Prints status information from device. 



FORMAL NAME: 



STATUS DUMP 



SYNTAX: 




PARAMETERS: 



S_ - dump last SIO program 
T - dump last TIO status 
D - dump last CCG status 



OPERATION: 



Status Dump will print status information obtained from the device regardless if an 
error has occurred or not. 

NOTE 

If a SIO program dump is requested and the last SIO program is not 
available the following informative message will be printed: 

D 7 NO CURRENT SIO PROGRAM 



EXAMPLE: 



> 10 DEV 0,127,24,3,0 

> 10 MC 

> 20 TIO 

> 30 STAT T 

> 40 END 

> 50 RUN 

D3 LAST TIO STATUS IS 1 100 101 011 100 000 

> 50 

The above example obtains a TIO Status Dump using the STAT T command. 

> 10 DEV 0,6,18,10,0 

> 10 WIO 0,123 

> 20 STAT D 

> 30 END 

> 40 RUN 

E1 WIO FAILED IN STEP 10 CONDITION CODE=CCG 

D4 LAST CCG STATUS IS 1 001 000 000 001 110 

> 40 

The above example obtains the last CCG status using the STAT D command. 

> 10 DEV 0,5,24,10,0 

> 10 NAME CA 

> 10 SENS 

> 10 ENDS,I 

> 10 SIO 0,CA,1,5,%1 777777,% 177777 

> 20 STATS 

> 30 END 

> 40 RUN 

D5 LAST SIO PROGRAM EXECUTED IS 
35702: 50000 10000 34000 30000 
D6 SIO PROGRAM POINTER EQUALS 35706 

> 40 

The above example uses the STAT S command to display the last SIO program. 
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SUPPRESS STATUS 

Disables automatic check of status. 



ss 



FORMAL NAME: 


SUPPRESS STATUS 


SYNTAX: 


> SS 




OPERATION: 


Suppress Status will disable 


EXAMPLE: 


> 10 DEV 0,5,13,10,0 




> 10 DB AA, 128,0 




> 10 SEEK 0,100,0,0 




> 20 SS 




> 30 RD 0,AA,200,0,0 




> 40 END 




> 50 RUN 




> 50 





The above example suppresses the status using the SS command then attempts an 
invalid read. The status is not checked. 
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SOUT SWITCH OUTPUT 



FORMAL NAME: SWITCH OUTPUT 



SYNTAX: 



> SOUT 



OPERATION: Switch Output will output error messages to the lineprinter or the system console. 

Initially error messages will be output to the system console. Each SOUT command will 
alternate the output device for error messages. This command will only be effective if 
the lineprinter's DRT number has been configured on the SLEUTH cold-load tape. 

EXAMPLE: > 10 DEV 0,11,5,100,0 

> 10 DB AA,66,S 

> ABC 

> 10 MC 

> 20 WD 0.AA.2 

> 30 SOUT 

> 40 LOOP 20,10 

> 50 END 

> 60 RUN 

> 60 

The above example will alternate the output of error messages if errors are encoun- 
tered. 
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TDIL TERMINAL DATA INTERFACE LOOP 



FORMAL NAME: TERMINAL DATA INTERFACE LOOP 



SYNTAX: 



> TDIL lunl ,lun2 ,bufl Mf 2 



PARAMETERS: lunl ) T . . ^ , , 

-j — ~ \ Logical unit numbers; must be asynchronous multiplexers. 

h r 9 } Buffers into which data is read. Buffers must be of equal length. 

OPERATION: Terminal Data Interface Loop will transfer data from LUN 1 to LUN2, and from BUF 1 

to BUF 2. A test cable is installed between the LUN1 and LUN 2 and data will be 
transferred one byte at a time until the buffers are exhausted. 

DELAY TIME: The default interrupt time out is 400 milliseconds/character. 

EXAMPLE: > 10 DEV 0,10,6,20,14,2400 

> 10 DEV 1,10,6,20,15,2400 

> 10 DB AA,4000,R 

> 10 DB BB,4000,0 

> 10 TDIL 0,1,AA,BB 

> 20 CB 0,AA,BB,5 

> 30 END 

> 40 RUN 

> 40 

The above example shows a 4000 word buffer of random data being transmitted one 
byte at a time from port 14 to port 15 through a test loop using the TDIL command. 
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TEST I/O 

Issues TIO to. device. 



TIO 



FORMAL NAME: 



TEST I/O 



SYNTAX: 



> TIO lun 



PARAMETER: 



lun 



Logical unit number. 



OPERATION: 



Test I/O will issue a Test I/O to the logical unit indicated. The TIO status may be 
displayed with a STAT T command. 



EXAMPLE: 



> 10 DEV 0,5,17,100,0 

> 10 MC 

> 20 TIO 

> 30 STAT T 

> 40 END 

> 50 RUN 

D3 LAST TIO STATUS IS 1 000 000 000 010 100 

> 50 

The above example issues a Test I/O to device number 5, and displays the status using a 
STAT T command. 
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XDUI 



UNIVERSAL INTERFACE 
DATA TRANSFER 



FORMAL NAME: 



UNIVERSAL INTERFACE DATA TRANSFER 



SYNTAX: 



PARAMETERS: 



> XDUI lun,bufl,buf2,mode 



lun 



bufl 
buf2 



mode 



Logical unit number; must be a Universal Interface with a test 
hood installed. 

Buffer from which data is transferred. 

Buffer to which data is transferred. 

Specifies byte mode [_B] or word mode [W]. Default is word 
mode. 



OPERATION: 



Universal Interface Data Transfer will execute a data transfer test on the indicated 
Universal Interface. 



DELAY TIME: 



The default interrupt time out per word is 100 milliseconds. 



EXAMPLE: 



> 10 DB AA,4000,R 

> 10 DB BB,4000,0 

> 10 DEV 0,9,25,100,0 

> 10 XDUI 0,AA,BB,B 

> 20 CB 0,AA,BB,5 

> 30 END 

> 40 RUN 

> 40 

The above example transfers data through a Universal Interface from buffer AA to 
buffer BB in byte mode. The read buffer is then compared to the write buffer using the 
CB command. 
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VERIFY 

Verifies data. 



VER 



FORMAL NAME: VERIFY 



SYNTAX: 



PARAMETERS: 



> VER lun,seccount [, cylinder, head, sector] 



lun 

seccount 

cylinder 

head 

sector 



Logical unit number; must be a 7905 disc. 
Number of sectors to be verified. 

Disc parameter indicating the starting address. Default is 0,0,0. 



OPERATION: 



The Verify command will verify the data on a number of sectors of a 7905 disc. 



DELAY TIME: 



The default interrupt time out is 2 seconds. 



EXAMPLE: 



> 10 DEV 0,5,15,100,0 

> 10 SFM 0,7 

> 20 FOR i=0TO 410 

> 30 SEEK 0,1,0,0 



> 40 VER 0,144,1,0,0 

> 50 NEXT I 

> 60 END 

> 70 RUN 

> 70 

The above example verifies one cylinder at a time until the entire disc is checked. 
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VERI 



VERIFY IMMEDIATE 



Verifies data. 



FORMAL NAME: 



VERIFY IMMEDIATE 



SYNTAX: 



> VERI lun,seccount 



PARAMETERS: 



lun 
seccount 



Logical unit number; must be a 7905 disc. 
Number of sectors to be verified. 



OPERATION: 



Verify Immediate will verify the data on a number of sectors of a 7905 disc. The starting 
point will be the internal disc address. 



DELAY TIME: 



The default interrupt time out is 2 seconds. 



EXAMPLE: 



> 10 DEV 0,5,15,100,0 



> 10 RS 

> 20 WDI 0,AA 

> 30 VERI 0,1 

> 40 LOOP 10,500 

> 50 END 

> 60 RUN 

> 60 

The above example seeks to random locations, writes, and verifies one sector. 
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WIO 



WIO 



Issues a WIO to device. 



FORMAL NAME: 



WIO 



SYNTAX: 



PARAMETERS: 



> WIO lun,word 



lun 
word 



Logical unit number. 

Octal word pattern to be written. 



OPERATION: 



WIO will issue a write I/O command of the octal word specified in the "WORD' 
parameter. 



EXAMPLE: 



> 10 DEV 0,15,24,5,0 

> 10 DB AA.1,%12345 

> 10 DB BB.1,0 

> 10 MC 

> 20 CIO 0,50 

> 30 WIO0,%12345 

> 40 RIO 0,BB 

> 50 CB 0.AA.BB.1 

> 60 END 

> 70 RUN 

> 70 

The above example selects the limit register of a clock console interface, issues a WIO of 
the pattern % 12345, then it issues an RIO and compares the data read to the data 
written. 



5-136 



WRIT 



WRITE 



FORMAL NAME: 



WRITE 



SYNTAX: 



> WRIT buf[ CJ 



PARAMETERS: 



buf 



Buffer into which data is written. Buffer's length determines 
word count of the write. Maximum is 4k. 



Indicates a chained order. 



OPERATION: 



The Write command will place a Write order in a SIO chain. (See NAME and SIO 
commands.) 



EXAMPLE: 



> 


10 DEV 0,7,14,5,0 


> 


10 DB AA,2944,R 


> 


10 NAME WR 


> 


10 CONT0,%1 00000 


> 


10 WRIT AA,C 


> 


10 WRIT AA,C 


> 


10 WRIT AA,C 


> 


10 WRIT AA,C 


> 


10 WRIT AA,C 


> 


10 WRIT AA,C 


> 


10 WRIT AA,C 


> 


10 WRIT AA,C 


> 


10 WRIT AA,C 


> 


10 WRIT AA,C 


> 


10 WRIT AA,C 


> 


10 WRIT AA,C 


> 


10 WRIT AA,C 


> 


10 WRIT AA,C 


> 


10 WRIT AA,C 


> 


10 WRIT AA,C 


> 


10 WRIT AA,C 


> 


10 WRIT AA,C 


> 


10 WRIT AA,C 


> 


10 WRIT AA 


> 


10 ENDS,! 


> 


10 SEEK 


> 


20 SIO 0,WR,1,7,%1 70000,0 


> 


30 END 


> 


40 RUN 


> 40 



The above example uses write orders to form an SIO program which writes a full 
cylinder on an ISS disc. 
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WRITE ADDRESS 

Writes one track of disc addresses on an ISS disc. 



WA 



FORMAL NAME: 



WRITE ADDRESS 



SYNTAX: 



PARAMETERS: 



> WA lun [ cylinder, head, sector] 



lun 

cylinder 

head 

sector 



Logical unit number; must be an ISS disc. 



Disc parameters specifing starting address regardless of actual 
position of heads. 



OPERATION: 



Write Address will write one track of disc addresses on an ISS disc. 



DELAY TIME: 



The default interrupt time out is 300 milliseconds. 



EXAMPLE: 



> 10 DEV 0,7,14,20,0 

> 10 SEEK 0,405,0,0 

> 20 WA 0,405,0,0 

> 30 END 

> 40 RUN 

> 40 

The above example program performs a Write Address operation on one track starting 
at cylinder 405, head 0, sector 0. 
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WAI 



WRITE ADDRESS IMMEDIATE 



FORMAL NAME: WRITE ADDRESS IMMEDIATE 



SYNTAX: 



> WAI lun 



PARAMETER: 



lun 



Logical unit number; must be an ISS disc. 



OPERATION: 



Write Address Immediate will write one track of disc addresses on an ISS disc. The 
internal disc address will be used as the starting point. 



DELAY TIME: 



The default interrupt time out is 300 milliseconds. 



EXAMPLE: 



> 10 DEV 0,7,14,5,0 

> 10 IT 

> 20 WAI 

> 30 LOOP 10,8119 

> 40 END 

> 50 RUN 

> 50 



The above example writes addresses on an ISS disc. 
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WRITE DATA 



WD 



Write data. 



FORMAL NAME: 



SYNTAX: 



WRITE DATA 





Format 


> WD lun,buf [, cylinder , head, sector] 


1 


> WD lun,buf[,mask [, cylinder, head, sector]] 


2 


> WD lun ,buf '[, track , arc] 


3 


> WD lun, buf line length 


4 


> WD lun, buf, mode, linelength 


5 


> WD lun, buf, mode 


6 


> WD lun, buf 


7 


> WD lun, buf [mode[ ,print[ ,hopper[ , stacker]]]] 


8 





OPERATION 



Write Data will execute a Write operation on the LUN indicated. Due to the variance of 
writable devices 8 discrete formats are required. 

Format 1: Will be utilized with ISS and 7900 discs. The "CYLINDER", "HEAD", 
"SECTOR" parameters will indicate the starting point of the write. Default is 0,0,0. 



Format 2: Will be used on 7905 discs. The file mask on the controller will be loaded 
with the value in the MASK parameter. Default is cylinder mode. 



Bits 

8-11 
12 



Function 



Number of retries allowed. 



Incremental/Decremental Seek. If set and bit 15 is a 1, the cylinder 
address will be decremented when End-of-Cylinder; otherwise, 
incremented. 



13 Allow sparing. 

14 Cylinder/Surface mode. If set, a cylinder consists of all available 
surfaces; End-of-Cylinder is set when the last sector of the last 
surface has been transferred. In surface mode, End-of-Cylinder is 
set when the last sector of any surface has been transferred. 

15 Allow Incremental/Decremental seek. 



The "CYLINDER", "HEAD", "SECTOR" parameters will designate the starting point 
of the write. Default is 0,0,0. 



Format 3: Will be used on fixed head discs. The "TRACK", "ARC" parameters will 
indicate the starting point of the write. Default is 0,0. 



Format 4: Will be utilized with terminal devices attached to the Asynchronous 
Multiplexor. The "LINELENGTH" parameter will indicate the length of each line. 
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WD 



WRITE DATA 



Continued 



Format 5: Will be used with lineprinters. The "MODE" parameter will be the format 
character and will be one of the following: 



OCTAL 
CODE 


9 


10 


BIT 
11 12 


13 


14 


15 


COMMAND 


000 
001 
002 
























1 




1 




SUPPRESS SPACE 
SINGLE SPACE 
DOUBLE SPACE 


077 





1 


1 1 


1 


1 


1 


63 SPACES 


100 
101 
102 
103 
104 
105 
106 
107 














oooooooo 
oooooooo 







1 
1 
1 
1 





1 
1 




1 
1 




1 



1 



1 



1 


Chan 1 (Top of form)* 

Chan 2 (Bottom of form)* 

Chan 3 (Single space forms* step-over) 

Chan 4 (Double space forms step-over) 

Triple space forms step-over* 

Next one-half page* 

Next one-fourth page* 

Next one-sixth page* 


*Assigned 


accord 


ing to HP 


programming 


standards. 







The "LINELENGTH" parameter will indicate the length of each line. 

Format 6: Will be used on the paper tape punch and SEL CHAN MAINT cards. The 
"MODE" parameter will indicate the transfer mode and will be one of the following: 

PAPER TAPE PUNCH 

W - Word mode 
B - Byte mode 

SEL CHAN MAINT CARD 

F - Fast Request Mode 
S - Slow Request Mode 



Format 7: Will be used with Mag Tape and the Plotter. 
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WRITE DATA 



Continued 



WD 



Format 8: Will be used on the Reader/Punch. The MODE parameter may be one of the 
following; 

C - Column Binary 
H - Hollerith 

Default is Hollerith to ASCII conversion. The PRINT parameter indicates the type of 
printing and punching to be performed and may be one of the following; 

P - Print and Punch Data 
N - No punching, print only 
S,BUF - Separate Print Data Supplied from a buffer designated in the BUF 
parameter. 

Default is Print/Punch Data. The HOPPER/STACKER parameters indicate the source 
and destination of cards and may be one of the following; 

1 - Primary Hopper/Stacker 
- Secondary Hopper/Stacker 

DEV 0,22,10,100,0 
DB AA,40,0 
CHB AA,%30060 
FOR l=0TO 9 
WD 0,AA 
CHB AA,I 
FOR J^O TO 7 
CHB AA,S 
NEXT J 
CHB AA.I 
NEXT I 
END 
RUN 





s 


> 


10 I 


> 


10 I 


> 


10i 


> 


20 1 


> 


30' 


> 


40 < 


> 


50 1 


> 


60 < 


> 


70 1 


> 


80 ( 


> 


90 1 


> 


100 I 


> 


110 I 


> 


110 



DELAY TIMES: 



The following are default interrupt time outs: 



DEVICE 

Async Mux 

Discs 

Tape 

Plotter 

Lineprinter 

Paper Tape Punch 

Reader/Punch 



TIME OUT 

300 milliseconds 
300 milliseconds 

5 seconds 

2 minutes 

4 seconds 
20 seconds 

7 seconds 
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WD WRITE DATA 



Continued 



EXAMPLES: 



> 


10 DEV 0,12,6,100,0,2400 


> 


10 DB AA,35,S 


> 


X 


> 


10 LET A=1 


> 


20 WD 0,AA,A 


> 


30 LET A=A+1 


> 


40 LOOP 20,68 


> 


50 LET A=A-1 


> 


60 WD 0,AA,A 


> 


70 LOOP 50,67 


> 


80 LOOP 10,5 


> 


90 END 


> 


100 RUN 


> 


100 



The above is an example of Write Data on the Async Mux. The line length in the 
variable A is modified each write. 



> 10 DEV 0,11,5,100,0 

> 10 DB AA,66,S 

> E 

> 10 WD O.AA.1,132 

> 20 LOOP 10,100 

> 30 END 

> 40 RUN 

> 40 

The above example writes on a lineprinter with single space with a line length of 132 
characters. 



> 10 DEV 0,7,21,15,0 

> 10 DB AA,200,R 

> 10 WD 0,AA,B 

> 20 END 

> 30 RUN 

> 30 

The above example writes a 200 word buffer of random data on a paper tape punch. 



> 10 DEV 0,5,17,25,0 

> 10 DB AA,4000,R 

> 10 DB BB,4000,0 

> 10 WD 0,AA, 100,5 

> 20 RD 0,66,100,5 

> 30 CB 0,AA,6B,4 

> 40 END 

> 50 RUN 

> 50 

The above example writes 4000 words of random data starting at track 100, sector 5. 
Then reads and checks the data on a fixed head disc. 
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WRITE DATA WD 



Continued 



EXAMPLES: > 10 DEV 0,6,18,35,0 

> 10 DB AA,8000,R 

> 10 WD O.AA 

> 20 LOOP 10,50 

> 30 REWO 

> 40 END 

> 50 RUN 

> 50 



The above example writes records of 8,000 random words of data 51 times on magnetic 
tape. 



> 10 DEV 0,5,15,100,0 

> 10 DB AA,6144,R 

> 10 FOR NO TO 410 

> 20 SEEK 0,1,0,0 

> 30 WD 0,AA,7,I,0,0 

> 40 NEXT I 

> 50 END 

> 60 RUN 

> 60 

The above example fills one full surface of a 7905 disc with random data. 
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WD! 



WRITE DATA IMMEDIATE 



Writes data. 



FORMAL NAME: 



SYNTAX: 



WRITE DATA IMMEDIATE 




> WDI lun,buf 

> WDI lun,buf[,mask] 


Format 
1 
2 



PARAMETERS: 



lun 
buf 

mask 



Logical unit number; must be a moving head disc. 

Buffer into which data will be written. Buffer length determines 
word count of the write. 

Loads file mask on controller. Default in cylinder mode. The 
mask bits are: 



Bits 

8-11 
12 

13 
14 



Function 



Number of retries allowed. 



Incremental/Decremental Seek. If set and bit 15 is a 1, the cylinder 
address will be decremented when End-of-Cylinder; otherwise, 
incremented. 

Allow sparing. 

Cylinder/Surface mode. If set, a cylinder consists of all available 
surfaces; End-of-Cylinder is set when the last sector of the last 
surface has been transferred. In surface mode, End-of-Cylinder is 
set when the last sector of any surface has been transferred. 

15 Allow Incremental/Decremental seek. 



OPERATION: 



Write Data Immediate will write data on a moving head disc. Format 1 will be used on 
7900 and ISS discs. Format 2 will be used on the 7905 disc. The Internal Disc Address 
will designate the starting point of the write. 



DELAY TIME: 



The default interrupt time out is 300 milliseconds. 



EXAMPLE: 



> 10 DEV 0,5,15,100,0 

> 10 DBAA,128,%1 55555 

> 10 RS 

> 20 WDI 0,AA,7 

> 30 LOOP 10,100 

> 40 END 

> 50 RUN 

> 50 

The above example randomly seeks and writes data on a 7905 disc. Sparing is enabled. 
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WRITE FILE MARK 

Write a file mark on magnetic tape. 



WFM 



FORMAL NAME: WRITE FILE MARK 



SYNTAX: 



> WFM lun 



PARAMETER: 



lun 



Logical unit number; must be a magnetic tape unit. 



OPERATION: 



Write File Mark will write a file mark on a magnetic tape. 



DELAY TIME: 



The default interrupt time out is 200 milliseconds. 



EXAMPLE: 



> 10 DEV 1,6,18,3,0 

> 10 DB FF,6000,%22222 

> 10 WD 1,FF 

> 20 WFM 1 

> 30 REW 1 

> 40 FSF 1 

> 50 RST 1 

> 60 END 

> 70 RUN 

> 70 



The above example writes a file mark on magnetic tape, rewinds, then forward spaces to 
the file mark. 
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WFS 



WRITE FULL SECTOR 

Performs a write full sector operation. 



FORMAL NAME: 



WRITE FULL SECTOR 



SYNTAX: 



PARAMETERS: 



> WFS lun,buf[, cylinder, head, sector] 



lun 

buf 

cylinder 

head 

sector 



Logical unit number; must be a moving head disc. 
Buffer in which data is written. 



Disc parameters specifying starting point of the write operation. 
Default is 0,0,0. 



OPERATION: 



Write Full Sector executes a Full Sector Write operation on a moving head disc. 



DELAY TIME: 



The default interrupt time out is 300 milliseconds. 



EXAMPLE: 



> 10 DEV 1,7,14,10,0 

> 10 DB AA,1 29, %1 25252 

> 10 DB BB,129,0 

> 10 SEEK 1,400,3,5 

> 20 WFS 1,AA,400,3,5 

> 30 RFS 1,BB,400,3,5 

> 40 CB 1,AA,BB,5 

> 50 END 

> 60 RUN 

> 60 

The above example performs a single write full sector and a read full sector on an ISS 
Disc. The buffers are then checked to verify the data. 



NOTE 

If Full Sector Write Operations are performed the disc should be 
reformatted afterwards. 
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WRITE FULL SECTOR IMMEDIATE 

Performs a full sector write operation. 



WFSI 



FORMAL NAME: 



WRITE FULL SECTOR IMMEDIATE 



SYNTAX: 



PARAMETERS: 



> WFSI lun,buf 



lun 
buf 



Logical unit number; must be a moving head disc. 

Buffer into which data is written. Buffer length determines 
word count of the write. 



OPERATION: 



Write Full Sector Immediate will perform a Full Sector Write operation on a moving 
head disc. The internal disc address will be used as the starting point. 



DELAY TIME: 



The default interrupt time out is 300 milliseconds. 



NOTE 

If Full Sector Write Operations are performed the disc should be 
reformatted afterwards. 



EXAMPLE: 



> 10 DEV 0,5,14,30,0 

> 10 DB AA.2967.R 

> 10 DB BB,2967,0 

> 10 SEEK 

> 20 WFSI 0,AA 

> 30 RFS 0, BB 

> 40 CB 0,AA,BB,5 

> 50 END 

> 60 RUN 

> 60 

The above example uses the Write Full Sector Immediate command to write one track 
of random data on an ISS Disc. The data is then read and compared. 
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WRZ WRITES A RECORD WITH ZERO PARITY 

Writes a record with zero parity. 



FORMAL NAME: 



WRITE RECORD WITH ZERO PARITY 



SYNTAX: 



> WRZ lun,buf 



PARAMETERS: 



lun 
buf 



Logical unit number; must be a magnetic tape unit. 

Buffer into which data is written. Buffer length determines 
word count of the write. 



OPERATION: 



Write Record With Zero Parity will write a record with zero parity on a magnetic tape. 



DELAY TIME: 



The default interrupt time out is 5 seconds. 



EXAMPLE: 



> 10 DEV 0,6,18,10,0 

> 10 DB AA,8000,R 

> 10 WRZ O.AA 

> 20 REW 

> 30 END 

> 40 RUN 

> 40 



The above example writes one record without parity using the WRZ command. 



5-149 



ZERO BUFFER 



ZBUF 



Zero the buffer. 



FORMAL NAME: 



ZERO BUFFER 



SYNTAX: 



> ZBUF buf 



PARAMETER: 



buf 



Buffer to be zeroed. 



OPERATION: 



Zero Buffer will zero the indicated buffer. 



EXAMPLE: 



> 10 DEV 0,5,14,20,0 

> 10 DB AA,2944,%55555 

> 10 DB BB,2944,0 

> 10 IS 00,19,0 

> 20 WDI 0,AA 

> 30 ZBUF BB 

> 40 RDI 0,BB 

> 50 CB 0,AA,BB,5 

> 60 LOOP 10,404 

> 70 END 

> 80 RUN 

> 80 



The above program writes data across the disc on head 19. Each track is read and 
compared. The ZBUF command is used to zero the read buffer before each read. 
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Table A-l. Index of Commands and Mnemonics 





MNEMONIC 


VARIABLE 


ACB 


8UFiiNDEX)=PRIWiARY 




VARIABLE = BUF(INDEX) 


AR 


LUN [,CYL,HD,SEC] 


AUTO 


[STEPN] 


BA 


1RECORD/E) 


BSF 


LUN 


BSR 


LUN 


BUMP 


[PI 


CA 


LUN 


CB 


LUN.BUF1 .BUF2.ERRCOUNT 


CC 


LUN,SECOUNTl,CYL,HEAD,SEC) 


CCI 


LUN.SECOUNT 


CHB 


BUF.TYPE 


CIO 


LUN.CONTROLWORD 


CL 


LUN 


CLR 


LUN, BUFF ER[,CYL,HEAD,SECl 


CLUB 
CONF 


LUN 



INDEX OF COMMANDS AND MNEMONICS 



CONT 

CORB 

DB 

DELY 

DEV 


WORD1.WORD2 

LUN.BUF 

NAME, LENGTH, DATA TYPE 

RESOLUTION 

LUN, DRT.TYP, ERR, UNITL BAUD] 


DISP 

DS 

DUMP 


LUN.TYPE 

LUN[,CYL,HEAD,SECl 

PARAM[,PARAM] 


END 

ENDS 

EP 


LI] 
[S] 


ES 

ESTA 
FMT 
FOR 


STATUS.MASK 

LUN[,L/U] 

<VAR> = <PRI >TO <PRI > 


FSF 


LUN 


FSR 

FTD 


LUN 
LUN[,CYL,HEAD,SEC] 


FTDI 


LUN 


GAP 


LUN 


GET 


VAR 


GO 
GOTO 
HALT 


LUN 

STEPN, EXPSTATUS, MASK 

STEPN 



LUN, BUFF [,CYL,HEAD,SEC] 

LUN, BUFF 

< PRIX RE LOP > <PRI>THEN<STEP> 



IR 


LUN.BUFF.TRACK.ARC 


IS 


LUN[,CYL,HEAD,SEC] 


IT 


LUN[,CYL,HEAD,SEC] 


IW 


LUN.BUFF.TRACK.ARC 


JUMP 


ADDRESSI.C] 


LET 


<VAR> = <EXPR> 


LIST 


VARl.BASE] 


LOOP 


STEPN.TIMES 


LTIO 


LUN.WORD 


MAKT 


[A/N] 


MC 


LUN 


NAME 


SIOPROG 


NEXT 


VAR 


NOPR 




PCT 


LUN .PATTERN 


PF 




POLL 


LUN 



COMMAND NAME 

ACCESS BUFFER 

ADDRESS RECORD 
AUTO NUMBER STEPS 
BATCH IN TESTS 
BACKSPACE FILE 
BACKSPACE RECORD 
BUMP PASS COUNT 
COMPARE ADDRESS 
COMPARE BUFFERS 
CYCLIC CHECK 
CC IMMEDIATE 
CHANGE BUFFER 
CONTROL I/O 
CLEAR 

COLD LOAD READ 
CLEAR UNIT BUSY 

CONFIGURE 
CONTROL ORDER, SIO 

CORRECT BUFFER 

DEFINE BUFFER 

DELAY 

DEVICE 

DISPLAY 

DECREMENTALSEEK 

DUMP QUANTITY 

END COMMAND 

END ORDER.SIO 

ERASE PROGRAM 

ENABLE STATUS 

EXPECTED STATUS 

FORMAT 

FOR 

FORWARD SPACE FILE 

FORWARD SPACE RECORD 

FLAG TRACK DEFECTIVE 

FTD IMMEDIATE 

GAP MAG TAPE 

GET 

CONDITIONAL BRANCH 

GOTO 

HALT%17 

INITIALIZE DATA 

ID IMMEDIATE 

IF 

INTERRUPT ORDER, SIO 

INCREMENTAL READ 

INCREMENTAL SEEK 

INCREMENTAL TRACK 

INCREMENTAL WRITE 

JUMP ORDER.SIO 

LET 

LIST 

BRANCH 

LOADTIO REGISTER 

MAKE TEST TAPE 

MASTER CLEAR 

NAME SIO PROGRAM 

NEXT 

NO PRINT 

PACK CERTIFICATION 

PAUSE ON ERROR 

RESUME POLLING 

PRINT 

PROCEED 



MNEMONIC 


VARIABLE 


PUT 


"STRING" 


RA 


LUN[,CYL,HEAD,SEC] 


RAI 


LUN 


RAND 


VAR 


RC 


LUN 


RCLK 


VAR 


RD 


LUN.BUF [.MODE.ETC] 


RDA 


LUN 


RDC 


LUN, BUFFER 


RDI 


LUN, BUFFER 


READ 


BUF[,C] 


REN 




REW 


LUN 


RFS 


LUN.BUF [, BUF, CYL, HE AD.SEC] 


RFSI 


LUN.BUF 


RIO 


LUN.BUF 


RMSK 


BUF 


RNFI 


LUN.BUF 


RNFS 


LUN,BUF[,CYL,HEAD,SEC] 


RP 


LUN.LINELENGTH 


RQST 


LUN 


RRES 




RS 


LUN 


RSA 


LUN 


RST 


LUN 


RSYN 


LUN 


RUA 


LUN 


RUN 




RWO 


LUN, BUF, MASK, OFFSET!, CYL.HD.SEC 


RWOI 


LUN, BUF, MASK, OFFSET 


RWV 


LUN.BUF [[.MASK] .CYL.HD.SEC] 


RWVt 


LUN.BUF [.MASK] 


SA 


LUN, BUF [,CYL, HE AD.SEC] 


SAI 


LUN.BUF 


SBNK 


BANK 


SCLK 


VALUE 


SED 


0/1 


SEEK 


LUN[,CYL,HEAD,SEC] 


SELU 


LUN, UNIT 


SENS 




SETJ 


LUN.JUMPERS 


SFM 


LUN.MASK 


SIN 


LUN 


SIO 


LUN,PROG,INTS.TIME,EST,MASK 


SKRD 


LUN, BUF[[, MASK], CYL.HD.SEC] 


SKWD 


LUN,BUF[[,MASK] .CYL.HD.SEC] 


SMSK 


MASKWORD 


SOUT 




SS 




STAT 


S/T/D 


TDIL 


LUN1,LUN2,BUF1,BUF2 


TIO 


LUN 


VER 


LUN,SECCOUNT[,CYL,HD,SEC] 


VERI 


LUN.SECCOUNT 


WA 


LUN[,CYL,HEAD,SECl 


WAI 


LUN 


WD 


LUN,BUF[,MODE ETC.] 


WDI 


LUN.BUF 


WFM 


LUN 


WFS 


LUN, BUF, CYL, HE AD, SECTOR 


WFSI 


LUN.BUF 


WIO 


LUN, WORD 


WRIT 


BUF[,C] 


WRZ 


LUN.BUF 


XDUI 


LUN, BUF1.BUF2, MODE 


ZBUF 


BUF 



COMMAND NAME 

PUT 

READ ADDRESS 

RA IMMEDIATE 

RANDOMIZE 

RECALIBRATE 

READ CLOCK 

READ DATA 

REQUEST DISC ADDRESS 

READ RECORD W/CRCC 

RD IMMEDIATE 

READORDER.SIO 

RENUMBER PROGRAM 

REWIND MAG TAPE 

READ FULL SECTOR 

RFS IMMEDIATE 

READ I/O 

READ MASK 

RNFS IMMEDIATE 

READ NEXT FULL SECTOR 

RIPPLE PRINT 

REQUEST STATUS 

RTN RESIDUE ORDER.SIO 

RANDOM SEEK 

REQUEST SECTOR ADDRESS 

REWIND & RESET 

REQUEST SYNDROME 

REQUEST UNIT ALLOCATION 

RUN COMMANDS 

READ WITH OFFSET 

READ WITH OFFSET IMMEDIATE 

READ WITHOUT VERIFY 

READ WITHOUT VERIFY IMMEDIATE 

SKIP ADDRESS READ 

SA IMMEDIATE 

SET BANK 

SET CLOCK 

SET ENABLE/DISABLE INT 

SEEK 

SELECT UNIT, MAG TAPE 

SENSE ORDER.SIO 

SET JUMPERS UNIV IFACE 

SET FILE MASK 

SET INTERRUPT 

START I/O 

SEEK READ DATA 

SEEK WRITE DATA 

SET MASK 

SWITCH OUTPUT 

SUPPRESS STATUS 

STATUS DUMP 

TERM DATA IFACE LOOP 

TEST I/O 

VERIFY 

VERIFY IMMEDIATE 

WRITE ADDRESS 

WA IMMEDIATE 

WRITE DATA 

WD IMMEDIATE 

WRITE FILE MARK 

WRITE FULL SECTOR 

WFS IMMEDIATE 

WRITE I/O 

WRITE ORDER.SIO 

WRITE REC W/0 PARITY 

XFR DATA UNIV IFACE 

ZERO BUFFER 



SWITCH REGISTER CONTROL 



CODED HALTS 



ENABLE SWITCH REGISTER 

ENABLE STATUS CHECKING 

NO PRINT 

PAUSE ON ERROR 

SWITCH PRINTOUT TO ALTERNATE DEV 

ENABLE SIO DUMP ON ERROR 



06 COLD LOAD HALT 

20 INTERRUPT FROM SEG < >0.1,2 OR 5 

20 ERROR HALT 

20 COMMAND HALT 
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Table A-2 List of Commands by Device Types 



GENERAL 


ISS DISC 


7900 DISC 


MAG TAPE 


DIRECT I/O 


SIO ORDERS 


7905 DISC 


ACB LET 


CA 


CC 


BSF 


CIO 


CONT 


AR 


AUTO LIST 


CC 


CCI 


BSR 


MC 


ENDS 


CL 


BA LOOP 


CCI 


DS 


FSF 


RIO 


INT 


CLUB 


BUMP MAKT 


CLR 


FMT 


FSR 


RMSK 


JUMP 


DISP 


CB MC 


DS 


FTD 


GAP 


SED 


READ 


DS 


CHB NAME 


FMT 


FTDI 


RD 


SIN 


RRES 


FMT 


CONF NEXT 


FTD 


ID 


RDC 


SIO 


SENS 


ID 


CORB NOPR 


FTDI 


IDI 


REW 


SMSK 


WRIT 


IDI 


DB PE 


IS 


IS 


RST 


TIO 




IS 


DELY PR 


IT 


IT 


SELU 


WIO 




IT 


DEV PROC 


PCT 


RC 


WD 




P.T. PUNCH 


LTIO 


DUMP PUT 


RA 


RD 


WFM 




WD 


POLL 


END RAND 


RAI 


RDI 


WRZ 


LINEPRINTER 




RC 


EP RCKL 


RC 


RFS 




RP 




RD 


ES REN 


RD 


RFSI 




WD 


CARD READER 


RDA 


ESTA RUN 


RDI 


RNFI 


F.H. DISC 




RD 


RDI 


FOR SBNK 


RFS 


RNFS 


IR 






RFS 


GO SCLK 


RFSI 


RS 


IW 


PLOTTER 




RFSI 


GOTO SOUT 


RS 


SEEK 


RD 


WD 




RQST 


GET SS 


SA 


WD 


WD 




SELECTOR 


RS 


HALT STAT 


SAI 


WDI 






CHANNEL 


RSA 


IF ZBUF 


SEEK 
WA 


WFS 
WFSI 


P.T. READER 


UNIVERSAL IF 
SETJ 


TEST BOARD 

RD 


RSYN 
RUA 




WAI 




RD 


XDUI 


WD 


RWO 




WO 










RWOI 




WDI 










RWV 




WFS 




ASYNC MUX 






RWVI 




WFSI 




RD 
RP 
TDIL 

WD 


_ _., 




SEEK 

SFM 

SKRD 

SKWD 

VER 

VERI 

WD 

WDI 

WFS 

WFSI 
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Command Name and Mnemonic 



Page No. 



INDEX OF COMMANDS 
Command Name and Mnemonic Page No. 



Command Name and Mnemonic 



Page No. 



Access Buffer (ACB) 5-4 

Address Record (AR) 5.5 
Automatic Numbering Resumed (AUTO) §_g 

Backspace File (BSF) 5-9 

Backspace Record (BSR) 5.10 

Batch (BA) 5.7 

Bump Pass Counter (BUMP) 5 _i 1 

Change Buffer (CHB) 5-12 

Clear (CD 5-13 

Clear Unit Busy (CLUB) 5.14 

Cold Load Read (CLR) 5-15 

Compare Address (CA) 5.1 6 

Compare Buffer (CB) 5-17 

Configure (CONF) 5-18 

Control (CONT) 5-20 

Control I/O (CIO) 5-21 

Correct Buffer (COR B) 5-22 

Cyclic Check (CO 5-23 

Cyclic Check Immediate (CCI) 5-24 

Decremental Seek (DS) 5-25 

Define Buffer (DB) 5-26 

Delay (DELY) 5-27 

Device (DEV) 5.28 

Display (DISP) 5-29 

Dump (DUMP) 5-30 

Enable Status (ES) 5-34 

End (END) 5-35 

End SI (ENDS) 5-36 

Erase Program (EP) 5.37 

Expected Status (ESTA) 5.33 

Flag Track Defective (FTD) 5-39 
Flag Track Defective Immediate (FTDI) 5-40 

For (FOR) 5-41 

Format (FMT) 5.42 

Forward Space File (FSF) 5.43 

Forward Space Record (FSR) 5-44 

Gap (GAP) 5-45 

Get (GET) 5-46 

Go (GO) 5-47 
Go To (GOTO) 5-47B 

Halt (HALT) 5-48 

If (IF) 5-49 

Incremental Read (IR) 5-50 



Incremental Seek (IS) 5-51 

Incremental Track (IT) 5-52 

Incremental Write (IW) 5-53 

Initialize Data (ID) 5-54 

Initialize Data Immediate (IDI) 5-56 

Interrupt (INT) 5-57 

Jump (JUMP) 5-58. 

Let (LET) 5-59 

List (LIST) 5-61 

Load TIO Register (LTIO) 5-62 

Loop (LOOP) 5-63 

Make Test Tape (MAKT) 5-64 

Master Clear (MC) 5-65 

Name SIO Program (NAME) 5-66 

Next (NEXT) 5-67 

No Print (NOPR) 5-68 

Pack Certification (PCT) 5-69 

Pause On Error (PE) 5-70 

Poll (POLL) 5-71 

Print (PR) 5-72 

Proceed (PROC) 5-73 

Put (PUT) 5-74 

Randomize (RAND) 5-75 

Random Seek (RS) 5-76 

Read (READ) 5-77 

Read Address (RA) 5-78 

Read Address Immediate (RAD 5-79 

Read Clock (RCLK) 5-80 

Read Data (RD) 5-81 

Read Data Immediate (RDI) 5-85 

Read Full Sector (RFS) 5-86 

Read Full Sector Immediate (RFSI) 5-87 

Read Mask (RMSK) 5-88 

Read Next Full Sector (RNFS) 5-89 
Read Next Full Sector Immediate (RNFI) 5-90 

Read Rec with CRCC (RDC) 5-91 

Read with Offset (RWO) 5-92 

Read with Offset Immediate (RWOI) 5-93 

Read without Verify (RWV) 5-94 
Read without Verify Immediate (RWVI) 5-95 

Recalibrate (RC) 5-96 

Renumber (REN) 5-97 

Request Disc Address (RDA) 5-98 

Request Sector Address (RSA) 5-99 

Request Status (RQST) 5-100 

Request Syndrome (RYSN) 5-101 



Request Unit Allocation (RUA! 

Return Residue (RRES) 

Rewind (REW) 

Rewind and Reset (RST) 

RIO (RIO) 

Ripple (RP) 

Run (RUN) 



Seek (SEEK) 

Seek Read Data (SKRD) 

Seek Write Data (SRWD) 

Select Unit (SELU) 

Sense (SENS) 

Set Bank (SBNK) 

Set Clock (SCLK) 

Set Enable/Disable Interrupts (SED) 

Set File Mask (SFM) 

Set Jumpers (SETJ) 

Set Mask (SMSK) 

SIN (SIN) 

SIO (SIO) 

Skip Address Read (SA) 

Skip Address Read Immediate (SAD 

Status Dump (STAT) 

Suppress Status (SS) 

Switch Output (SOUT) 



Terminal Data Interface Loop (TOIL) 
Test I/O (TIO) 



5-103 
5-104 
5-105 
5-106 
5-107 
5-108 
5-109 

5-110 
5-111 
5-112 
5-114 
5-115 
5-116 
5-117 
5-118 
5-119 
5-120 
5-121 
5-122 
5-123 
5-125 
5-126 
5-127 
5-128 
5-129 



5-131 
5-132 



Universal Interface Data Transfer (XDUD 5-133 



Verify (VER) 5-134 

Verify Immediate (VERD 5-135 

WIO (WIO) 5-136 

Write (WRIT) 5-137 

Write Address (WA) 5-138 

Write Address Immediate (WAD 5-139 

Write Data (WD) 5-140 

Write Data Immediate (WDI) 5-145 

Write File Mark (WFM) 5-146 

Write Full Sector (WFS) 5-147 

Write Full Sector Immediate (WFSD 5-148 

Write Record with Zero Parity (WRZ! 5-149 

Zero Buffer (ZBUF) 5-150 
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